---
title: "Get Project Usage Breakdown"
method: GET
path: "/v1/projects/{project_id}/usage/breakdown"
tags: ["breakdown"]
---

# Get Project Usage Breakdown

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

Retrieves the usage breakdown for a specific project, with various filter options by API feature or by groupings. Setting a feature (e.g. diarize) to true includes requests that used that feature, while false excludes requests that used it. Multiple true filters are combined with OR logic, while false filters use AND logic.

## Path parameters

- `project_id` string, required

## Query parameters

- `start` string, date
- `end` string, date
- `grouping` 'accessor' | 'endpoint' | 'feature_set' | 'models' | 'method' | 'tags' | 'deployment'
- `accessor` string
- `alternatives` boolean
- `callback_method` boolean
- `callback` boolean
- `channels` boolean
- `custom_intent_mode` boolean
- `custom_intent` boolean
- `custom_topic_mode` boolean
- `custom_topic` boolean
- `deployment` 'hosted' | 'beta' | 'self-hosted' — Deployment type for the requests
- `detect_entities` boolean
- `detect_language` boolean
- `diarize` boolean
- `dictation` boolean
- `encoding` boolean
- `endpoint` 'listen' | 'read' | 'speak' | 'agent'
- `extra` boolean
- `filler_words` boolean
- `intents` boolean
- `keyterm` boolean
- `keywords` boolean
- `language` boolean
- `measurements` boolean
- `method` 'sync' | 'async' | 'streaming' — Method type for the request
- `model` string
- `multichannel` boolean
- `numerals` boolean
- `paragraphs` boolean
- `profanity_filter` boolean
- `punctuate` boolean
- `redact` boolean
- `replace` boolean
- `sample_rate` boolean
- `search` boolean
- `sentiment` boolean
- `smart_format` boolean
- `summarize` boolean
- `tag` string
- `topics` boolean
- `utt_split` boolean
- `utterances` boolean
- `version` boolean

## Headers

- `Authorization` string, required

## Response `200`

Usage breakdown response

- UsageBreakdownV1Response
  - `start` string, date, required — Start date of the usage period
  - `end` string, date, required — End date of the usage period
  - `resolution` UsageBreakdownV1ResponseResolution, required
    - `units` string, required — Time unit for the resolution
    - `amount` number, double, required — Amount of units
  - `results` UsageBreakdownV1ResponseResultsItems[], required
    - `hours` string, required — Audio hours processed
    - `total_hours` string, required — Total hours including all processing
    - `agent_hours` string, required — Agent hours used
    - `tokens_in` number, double, required — Number of input tokens
    - `tokens_out` number, double, required — Number of output tokens
    - `tts_characters` number, double, required — Number of text-to-speech characters processed
    - `requests` number, double, required — Number of requests
    - `grouping` UsageBreakdownV1ResponseResultsItemsGrouping, required
      - `start` string, date — Start date for this group
      - `end` string, date — End date for this group
      - `accessor` string, nullable — Optional accessor identifier
      - `endpoint` string, nullable — Optional endpoint identifier
      - `feature_set` string, nullable — Optional feature set identifier
      - `models` string[]
      - `method` string, nullable — Optional method identifier
      - `tags` string[], nullable — Optional list of tags, null unless grouped by tags.
      - `deployment` string, nullable — Optional deployment identifier

## Other responses

- `400` — Invalid Request

---

[API](https://skmtc.net/deepgram/apis/rest-api.md) · [All operations](https://skmtc.net/deepgram/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deepgram/rest-api/revisions/bd7ba5c18a6b/schema)