> ## Documentation Index
> Fetch the complete documentation index at: https://deepl-c950b784-docs-pipeline-20260818-123016.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieving Usage Data

> Compare DeepL's usage data sources and pull character and minute consumption for your account, API keys, or custom tags.

DeepL offers several ways to retrieve usage data so you can track character and minute consumption and the associated costs. This guide compares the available data sources and shows how to use each one.

<Info>
  Consumption data in the account UI, in CSV exports, and in the [Admin API analytics endpoints](/api-reference/admin-api/get-usage-analytics) is available up to and including the previous UTC calendar day. For near-real-time data, use the [`/usage` endpoint](/api-reference/usage-and-quota/check-usage-and-limits).
</Info>

## Choose a data source

| Data source                                       | Scope                                             | Time range                                                       | Data freshness                  | Interface    |
| ------------------------------------------------- | ------------------------------------------------- | ---------------------------------------------------------------- | ------------------------------- | ------------ |
| [API Keys & Limits tab](#api-keys-and-limits-tab) | Per API key                                       | Current usage period only                                        | Previous UTC day                | Account UI   |
| [API Usage tab](#api-usage-tab)                   | Account total (plus year-to-date on yearly plans) | Current usage period (and yearly period)                         | Previous UTC day                | Account UI   |
| [CSV export](#csv-export)                         | Per API key or per custom tag                     | Custom or preset ranges up to 4 months, optional grouping by day | Previous UTC day                | CSV download |
| [`/usage` endpoint](#the-usage-endpoint)          | Account total                                     | Current usage period only                                        | Near-real-time (within minutes) | REST API     |
| [Admin API analytics](#admin-api-analytics)       | Per API key or per custom tag                     | Custom date range, optional grouping by day                      | Previous UTC day                | REST API     |

Use the **account UI** for a quick check while signed in, the **CSV export** for detailed or offline analysis per key or per custom tag, the **`/usage` endpoint** for programmatic near-real-time quota checks, and the **Admin API analytics endpoints** for programmatic reporting and cost attribution.

## API Keys and Limits tab

To check per-key consumption for the current monthly usage period, open the [API Keys & Limits tab](https://www.deepl.com/your-account/keys). It shows character and speech-to-text (STT) minute consumption for each API key.

<Frame caption="The API Keys & Limits tab">
  <img src="https://mintcdn.com/deepl-c950b784-docs-pipeline-20260818-123016/ETztmYlaZeYWot62/_assets/images/api-growth-api-keys-and-limits.png?fit=max&auto=format&n=ETztmYlaZeYWot62&q=85&s=d43a83a29e7b59b5cb8817d3c92b20a8" alt="" width="2994" height="1612" data-path="_assets/images/api-growth-api-keys-and-limits.png" />
</Frame>

## API Usage tab

To check your account totals, open the [API Usage tab](https://www.deepl.com/your-account/usage). It shows total character and STT minute usage for the current monthly usage period, and if you're on a yearly plan, usage to date for your yearly billing period, too.

<Frame caption="The API Usage tab">
  <img src="https://mintcdn.com/deepl-c950b784-docs-pipeline-20260818-123016/ETztmYlaZeYWot62/_assets/images/api-growth-annual-usage-tab.png?fit=max&auto=format&n=ETztmYlaZeYWot62&q=85&s=4292c5f488180dde810d8d70689be85b" alt="" width="3002" height="1698" data-path="_assets/images/api-growth-annual-usage-tab.png" />
</Frame>

## CSV export

Generate a CSV report of your usage for a chosen time period. Two report types are available:

* **API key-level report**: characters translated per API key, including a column that breaks out text improvement (Write API) characters separately. Key-level usage is not broken out on invoices; retrieve it via CSV export, the "API Keys & Limits" tab, or the [Admin API analytics endpoints](#admin-api-analytics).
* **Custom tag-level report**: usage broken down by [custom reporting tag](/docs/learning-how-tos/examples-and-guides/how-to-use-custom-reporting-tags). Only tagged requests appear in this report, so results reflect a subset of total usage unless every request is tagged.

To download a report, click "Download CSV usage report" on the [API Keys & Limits tab](https://www.deepl.com/your-account/keys) or the [API Usage tab](https://www.deepl.com/your-account/usage) and select "API key-level report" or "Custom tag-level report" from the dropdown. Then select a time period and click "Download your report".

<Frame caption="Select a report type from the &#x22;Download CSV usage report&#x22; dropdown">
  <img src="https://mintcdn.com/deepl-c950b784-docs-pipeline-20260818-123016/ETztmYlaZeYWot62/_assets/images/download-csv-usage-report.png?fit=max&auto=format&n=ETztmYlaZeYWot62&q=85&s=d3a660110fef653fa11157d9c3991759" alt="" width="2000" height="939" data-path="_assets/images/download-csv-usage-report.png" />
</Frame>

Select a custom date range of up to 4 months (on UTC calendar days) or one of the presets, which cover rolling windows from the last 24 hours up to the last year as well as calendar months and usage periods. Rolling presets include the current day; calendar-month and usage-period ranges align to UTC day or period boundaries, so they might not start and end on a full calendar day.

For any time range, you can also group usage data by UTC calendar day:

<Frame caption="Select the &#x22;Group by day&#x22; option to group usage data by UTC calendar day">
  <img src="https://mintcdn.com/deepl-c950b784-docs-pipeline-20260818-123016/ETztmYlaZeYWot62/_assets/images/group-by-day-option.png?fit=max&auto=format&n=ETztmYlaZeYWot62&q=85&s=917ecb90681dff8849402219abedd994" alt="" width="3824" height="1828" data-path="_assets/images/group-by-day-option.png" />
</Frame>

<Note>
  Document translation data is only included in reports with a time period starting on or after May 16, 2024 00:00 UTC. Text translation data is included for all time periods.
</Note>

## The usage endpoint

The [`/usage` endpoint](/api-reference/usage-and-quota/check-usage-and-limits) returns a near-real-time snapshot of character and minute usage in the current monthly usage period, typically up to date within a few minutes of the usage being generated. Use it for programmatic quota checks, for example before submitting a large translation batch.

## Admin API analytics

The [Admin API](/docs/admin/overview#the-admin-api) provides programmatic access to usage data over a custom date range, with optional grouping by day. It requires an [admin key](/docs/admin/managing-api-keys#manage-admin-api-keys) for authentication. Two endpoints are available:

* [Get usage analytics](/api-reference/admin-api/get-usage-analytics) returns usage statistics across all services (text translation, document translation, text improvement, and speech-to-text), in total or grouped by API key
* [Get custom tag usage analytics](/api-reference/admin-api/get-custom-tag-usage-analytics) returns usage broken down by custom tag

Custom tags are an optional dimension for cost attribution: attach a tag to individual API requests with the `X-DeepL-Reporting-Tag` header to track consumption by team, project, or any other category. Only tagged requests appear in custom-tag analytics, so results reflect a subset of total usage unless every request is tagged. See [How to use custom reporting tags](/docs/learning-how-tos/examples-and-guides/how-to-use-custom-reporting-tags) for setup and naming guidance. If you prefer a download over an API call, the same per-tag data is available as a [custom tag-level CSV export](#csv-export).

For a worked example of pulling analytics data into a dashboard, see the [usage analytics dashboard cookbook](/docs/learning-how-tos/cookbook/usage-analytics-dashboard).