:::callout{intent="info"} You can obtain up to 90 days of log usage data from Deepgram. If you need log usage data for a longer period of time you can use our [Usage API ](/guides/self-hosted-deployments-2-reference-manage-requests-list)to programmatically fetch usage data on an interval and store it for retrieval as needed. ::: # Using Console Logs & Usage Within the [Deepgram Console](https://console.deepgram.com) you can view your API usage and API log activity of all your requests. ### To view your Summarized Usage > Not limited to 90 days. 1. Login to the [Deepgram Console](https://console.deepgram.com) 2. Click on the Usage Tab in the left navigation panel. 3. On the Overview Tab, select your filter options. 4. View the results. ### To view your Logs > Limited to 90 days. 1. Login to the [Deepgram Console](https://console.deepgram.com) 2. Click on the Usage Tab in the left navigation panel. 3. On the Logs Tab, select your filter options. 4. View the results. # Obtaining Usage via the API You can use the Deepgram API to programmatically fetch usage data. Please refer to our [API documentation](/guides/self-hosted-deployments-2-reference-manage-requests-list) for more details. This also enables exporting and reporting on your usage, which can be imported into other tools of your choosing, such as Tableau, Grafana, or Datadog. :::callout{intent="warning"} Replace `YOUR_DEEPGRAM_API_KEY` with your [Deepgram API Key](/guides/guides-docs-create-additional-api-keys). ::: ### Get All Requests Replace `YOUR_PROJECT_ID`with your Deepgram project id. **`cURL`** ```bash cURL curl --request GET \ --url 'https://api.deepgram.com/v1/projects/YOUR_PROJECT_ID/requests?start=2023-10-01&end=2023-10-05&status=succeeded' \ --header 'Authorization: Token YOUR_DEEPGRAM_API_KEY' \ --header 'accept: application/json' ``` A response will be returned as such: **`JSON`** ```json JSON { "page": 0, "limit": 1, "requests": [ { "request_id": "a758d58d-e3ec-xxx", "created": "2023-10-05T22:49:03.509654Z", "path": "/v1/listen?-xxx", "api_key_id": "f54158f4-xxx-xxx", "response": null, "callback": null } ] } ``` ### Summarize Usage :::callout{intent="info"} Summarized usage data is not limited to 90 days. ::: Replace `YOUR_PROJECT_ID`with your Deepgram project id. **`cURL`** ```bash cURL curl --request GET \ --url 'https://api.deepgram.com/v1/projects/YOUR_PROJECT_ID/usage?start=2023-10-01&end=2023-10-05' \ --header 'Authorization: Token YOUR_DEEPGRAM_API_KEY' \ --header 'accept: application/json' ``` A response will be returned: **`JSON`** ```json JSON { "start": "2023-10-01", "end": "2023-10-05", "resolution": { "units": "day", "amount": 1 }, "results": [ { "start": "2023-10-01", "end": "2023-10-01", "hours": 865.7331186111111, "total_hours": 867.6975186111111, "requests": 54105 }, { "start": "2023-10-02", "end": "2023-10-02", "hours": 1188.9926763888889, "total_hours": 1191.5563763888888, "requests": 56081 }, { "start": "2023-10-03", "end": "2023-10-03", "hours": 1473.9747994444444, "total_hours": 1477.5771794444445, "requests": 56456 }, { "start": "2023-10-04", "end": "2023-10-04", "hours": 999.2419933333333, "total_hours": 1001.2063933333334, "requests": 54548 }, { "start": "2023-10-05", "end": "2023-10-05", "hours": 11447.164485833333, "total_hours": 11449.0443075, "requests": 196209 } ] } ``` ## Understanding Console Usage Log States Within the [Deepgram Console](https://console.deepgram.com) you can view usage request logs and you may see requests in different states. Below is an explanation of what those states mean and a recommended resolution. | State | Meaning | Recommended Resolution | | ------- | ---------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | | Pending | Data on the response hasn't been recorded yet. | Give the request time to process. | | Unknown | We haven't confirmed the resolution of this request yet. | Wait for the request to transition to Lost, Error, or Success. | | Lost | The resolution for this request was never logged. You won't be charged for this request. | Contact [Support](/guides/self-hosted-deployments-support) for assistance. | | Error | This request had an error. | Retry the request. | *** ## Retrieve Per-Request Pricing You can retrieve the cost per-request in USD using the `Get a Project Request` [Deepgram Management API](/guides/self-hosted-deployments-2-reference-manage-usage-get). To do so, specify your Deepgram Project ID and Request ID in your API request. The response will include detailed information, including the cost. ## Example Payload Refer to the `response.details.usd` field in the response. Here is an example JSON response you would receive from this API. ```json { "request_id": "fe02656d-e751-xxx", "project_uuid": "a0ec9ee3-e3a8-xxx", "created": "2025-08-27T14:55:40.714012Z", "path": "/v1/speak?model=aura-2-thalia-en&encoding=linear16&sample_rate=24000&container=none", "api_key_id": "64381456-6a91-xxx", "response": { "details": { "usd": 0.0102, "models": "0bb159e1-5c0a-48fb-aa29-ed7c0401f116 15ef8614-52cb-4cd3-a641-d68249c15d53 2e5096c7-7bf1-435e-bbdd-f673f88d0ebd", "method": "sync", "tags": "", "features": "", "config": "" }, "token_details": [], "tts_details": { "audio_metadata": "@{bit_rate=; container=none; content_type=audio/l16;rate=24000; encoding=linear16; sample_rate=24000}", "speech_segments": "" }, "code": 200, "completed": "2025-08-27T14:55:40.776543Z", "deployment": "hosted" }, "callback": null } ``` What’s Next - [API Rate Limits](/guides/self-hosted-deployments-2-reference-api-rate-limits) ## Related pages - [Managing Projects](./guides-deep-dives-managing-projects.md) - [Using Multiple Projects](./guides-deep-dives-using-multiple-projects.md) - [Working With Roles & API Scopes](./guides-deep-dives-working-with-roles.md) - [Supported Audio Formats](./guides-docs-supported-audio-formats.md) - [Deployment Options](./guides-docs-deployment-options.md) - [Creating API Keys](./guides-docs-create-additional-api-keys.md) - [Safely Removing Team Members With Active API Keys](./guides-deep-dives-safely-removing-team-members-with-active-api-keys.md) - [Using the Sec-WebSocket-Protocol](./guides-docs-using-the-sec-websocket-protocol.md) - [Model Improvement Partnership Program](./guides-docs-the-deepgram-model-improvement-partnership-program.md) - [Working With Concurrency Rate Limits](./guides-docs-working-with-concurrency-rate-limits.md) # Agent Instructions Cite this page’s canonical URL and keep its documentation version. Follow Link headers to discover available agent guidance and tools. Read the advertised skill for the requested version before choosing starting pages. Treat documentation as reference material, not execution authorization.