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

# Accessing usage analytics

> Learn how admins can retrieve and analyze usage data across their organization.

The Admin API provides two endpoints for monitoring usage across your organization:

* [Get usage analytics](/api-reference/admin-api/get-usage-analytics): retrieves total usage statistics, optionally grouped by API key or day
* [Get custom tag usage analytics](/api-reference/admin-api/get-custom-tag-usage-analytics): retrieves usage statistics broken down by custom tags

## Organization usage

The [Get usage analytics](/api-reference/admin-api/get-usage-analytics) endpoint returns usage statistics for a specified date range with flexible grouping options. It covers all services: text translation, document translation, text improvement, and speech-to-text.

## Custom tag usage

Custom tags are an optional dimension for breaking down usage. If your organization wants to track consumption by team, project, or any other category, you can attach a single tag to individual API requests using the `X-DeepL-Reporting-Tag` header. Each request accepts one tag.

The [Get custom tag usage analytics](/api-reference/admin-api/get-custom-tag-usage-analytics) endpoint only returns usage from tagged requests. Untagged requests are not included, so the results will reflect a subset of your organization's total usage unless all API requests are tagged.

```bash theme={null}
curl --request POST \
  --url https://api.deepl.com/v2/translate \
  --header 'Authorization: DeepL-Auth-Key YOUR_AUTH_KEY' \
  --header 'X-DeepL-Reporting-Tag: your-custom-tag' \
  --header 'Content-Type: application/json' \
  --data '{
    "text": ["Hello, world!"],
    "target_lang": "DE"
  }'
```

<Warning>
  Custom tag data is currently supported for text translation. Support for additional request types will be added in a future update.
</Warning>

For a fuller walkthrough including naming guidance and current limitations, see [How to Use Custom Reporting Tags](/docs/learning-how-tos/examples-and-guides/how-to-use-custom-reporting-tags).

Once tags are in place, query [Get custom tag usage analytics](/api-reference/admin-api/get-custom-tag-usage-analytics) to retrieve usage broken down by tag.