# Get Project Usage

**GET** `/v1/projects/{project_id}/usage`

> **Deprecated** — this operation is still served but should not be adopted in new integrations.

Retrieves the usage for a specific project. Use Get Project Usage Breakdown for a more comprehensive usage summary.

Base URL: `https://agent.deepgram.com`

Tags: `usage`

## Authorization

| Option | Scheme | Type | Sent as | Scopes |
| --- | --- | --- | --- | --- |
| Option 1 | `ApiKeyAuth` | `apiKey` | header `Authorization` | — |

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `project_id` | `string` | Yes | The unique identifier of the project |

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `start` | `string` (date) | No | Start date of the requested date range. Format accepted is YYYY-MM-DD |
| `end` | `string` (date) | No | End date of the requested date range. Format accepted is YYYY-MM-DD |
| `accessor` | `string` | No | Filter for requests where a specific accessor was used |
| `alternatives` | `boolean` | No | Filter for requests where alternatives were used |
| `callback_method` | `boolean` | No | Filter for requests where callback method was used |
| `callback` | `boolean` | No | Filter for requests where callback was used |
| `channels` | `boolean` | No | Filter for requests where channels were used |
| `custom_intent_mode` | `boolean` | No | Filter for requests where custom intent mode was used |
| `custom_intent` | `boolean` | No | Filter for requests where custom intent was used |
| `custom_topic_mode` | `boolean` | No | Filter for requests where custom topic mode was used |
| `custom_topic` | `boolean` | No | Filter for requests where custom topic was used |
| `deployment` | `string` | No | Filter for requests where a specific deployment was used Allowed values: `hosted`, `beta`, `self-hosted`. |
| `detect_entities` | `boolean` | No | Filter for requests where detect entities was used |
| `detect_language` | `boolean` | No | Filter for requests where detect language was used |
| `diarize` | `boolean` | No | Filter for requests where diarize was used |
| `dictation` | `boolean` | No | Filter for requests where dictation was used |
| `encoding` | `boolean` | No | Filter for requests where encoding was used |
| `endpoint` | `string` | No | Filter for requests where a specific endpoint was used Allowed values: `listen`, `read`, `speak`, `agent`. |
| `extra` | `boolean` | No | Filter for requests where extra was used |
| `filler_words` | `boolean` | No | Filter for requests where filler words was used |
| `intents` | `boolean` | No | Filter for requests where intents was used |
| `keyterm` | `boolean` | No | Filter for requests where keyterm was used |
| `keywords` | `boolean` | No | Filter for requests where keywords was used |
| `language` | `boolean` | No | Filter for requests where language was used |
| `measurements` | `boolean` | No | Filter for requests where measurements were used |
| `method` | `string` | No | Filter for requests where a specific method was used Allowed values: `sync`, `async`, `streaming`. |
| `model` | `string` | No | Filter for requests where a specific model uuid was used |
| `multichannel` | `boolean` | No | Filter for requests where multichannel was used |
| `numerals` | `boolean` | No | Filter for requests where numerals were used |
| `paragraphs` | `boolean` | No | Filter for requests where paragraphs were used |
| `profanity_filter` | `boolean` | No | Filter for requests where profanity filter was used |
| `punctuate` | `boolean` | No | Filter for requests where punctuate was used |
| `redact` | `boolean` | No | Filter for requests where redact was used |
| `replace` | `boolean` | No | Filter for requests where replace was used |
| `sample_rate` | `boolean` | No | Filter for requests where sample rate was used |
| `search` | `boolean` | No | Filter for requests where search was used |
| `sentiment` | `boolean` | No | Filter for requests where sentiment was used |
| `smart_format` | `boolean` | No | Filter for requests where smart format was used |
| `summarize` | `boolean` | No | Filter for requests where summarize was used |
| `tag` | `string` | No | Filter for requests where a specific tag was used |
| `topics` | `boolean` | No | Filter for requests where topics was used |
| `utt_split` | `boolean` | No | Filter for requests where utt split was used |
| `utterances` | `boolean` | No | Filter for requests where utterances was used |
| `version` | `boolean` | No | Filter for requests where version was used |

## Responses

| Status | Description | Media type |
| --- | --- | --- |
| `200` | A specific request for a specific project | `application/json` |
| `400` | Invalid Request | `application/json` |

### Example response: 200 — A specific request for a specific project

```json
{
  "end": "2026-06-09",
  "resolution": {
    "amount": 0,
    "units": "string"
  },
  "start": "2026-06-09"
}
```

### Example response: 400 — Invalid Request

```json
{
  "err_code": "string",
  "err_msg": "string",
  "request_id": "string"
}
```

## Related pages

- [Analyze text content](./text_analyze.md)
- [audio](./tags/audio.md)
- [balances](./tags/balances.md)
- [breakdown](./tags/breakdown.md)
- [configurations](./tags/configurations.md)
- [Create a Project Invite](./invites_create.md)
- [Create a Project Key](./keys_create.md)
- [Create a Project Self-Hosted Distribution Credential](./distributioncredentials_create.md)
- [Create an Agent Configuration](./configurations_create.md)
- [Create an Agent Variable](./variables_create.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.