---
title: "Get usage statistics as an admin"
method: GET
path: "/v2/admin/analytics"
tags: ["AdminApi"]
---

# Get usage statistics as an admin

`GET /v2/admin/analytics`

Retrieve usage statistics for the organization within a specified date range.
Optionally group the results by API key or by API key and day.

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required
- `group_by` 'key' | 'key_and_day'

## Response `200`

The usage statistics for the specified date range.

- AdminUsageReport — The response for admin usage statistics.
  - `usage_report` AdminUsageReportData — Contains the detailed usage statistics for the specified date range.
    - `total_usage` UsageBreakdown — Breakdown of character usage by category.
      - `total_characters` integer — Total number of characters used.
      - `text_translation_characters` integer — Number of characters used for text translation.
      - `document_translation_characters` integer — Number of characters used for document translation.
      - `text_improvement_characters` integer — Number of characters used for text improvement.
      - `speech_to_text_minutes` number — Duration of speech-to-text usage in minutes.
    - `start_date` string, date-time — Start date of the usage report period.
    - `end_date` string, date-time — End date of the usage report period.
    - `group_by` 'key' | 'key_and_day' — The grouping method used, if any.
    - `key_usages` KeyUsageItem[] — Usage statistics grouped by key. Present when group_by='key'.
      - `api_key` string — Masked API key identifier.
      - `api_key_label` string — Label associated with the API key.
      - `usage` UsageBreakdown — Breakdown of character usage by category.
        - `total_characters` integer — Total number of characters used.
        - `text_translation_characters` integer — Number of characters used for text translation.
        - `document_translation_characters` integer — Number of characters used for document translation.
        - `text_improvement_characters` integer — Number of characters used for text improvement.
        - `speech_to_text_minutes` number — Duration of speech-to-text usage in minutes.
    - `key_and_day_usages` KeyAndDayUsageItem[] — Usage statistics grouped by key and day. Present when group_by='key_and_day'.
      - `api_key` string — Masked API key identifier.
      - `api_key_label` string — Label associated with the API key.
      - `usage_date` string, date-time — The usage date. Only present when group_by is "key_and_day".
      - `usage` UsageBreakdown — Breakdown of character usage by category.
        - `total_characters` integer — Total number of characters used.
        - `text_translation_characters` integer — Number of characters used for text translation.
        - `document_translation_characters` integer — Number of characters used for document translation.
        - `text_improvement_characters` integer — Number of characters used for text improvement.
        - `speech_to_text_minutes` number — Duration of speech-to-text usage in minutes.

## Other responses

- `400` — Bad request. Please check error message and your parameters.
- `403` — Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header.
- `404` — The requested resource could not be found.
- `500` — Internal error.

---

[API](https://skmtc.dev/deepl/apis/deepl-api-documentation.md) · [All operations](https://skmtc.dev/deepl/apis/deepl-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deepl/deepl-api-documentation/revisions/3c422fcc9c54/schema)