---
title: "Check Usage and Limits"
method: GET
path: "/v2/usage"
tags: ["MetaInformation"]
---

# Check Usage and Limits

`GET /v2/usage`

## Response `200`

The account's usage and limits.

- UsageResponse
  - `character_count` integer — Characters translated so far in the current billing period.
  - `character_limit` integer — Current maximum number of characters that can be translated per billing period. If cost control is set, the cost control limit will be returned in this field.
  - `document_count` integer — Documents translated so far in the current billing period. Only present for accounts with a document limit.
  - `document_limit` integer — Current maximum number of documents that can be translated per billing period. Only present for accounts with a document limit.
  - `team_document_count` integer — Documents translated by all users in the team so far in the current billing period. Only present for accounts with a team document limit.
  - `team_document_limit` integer — Current maximum number of documents that can be translated by the team per billing period. Only present for accounts with a team document limit.
  - `products` object[] — Only present for API Pro users. Per-product usage details.
    - `product_type` string — The type of product (e.g., 'write', 'translate').
    - `billing_unit` 'characters' | 'minutes' — The billing unit for this product type.
    - `api_key_unit_count` integer — Units used for this product by this API key in the current period.
    - `account_unit_count` integer — Total units used for this product in the current period.
    - `api_key_character_count` integer — Use api_key_unit_count instead. Characters used for this product by this API key in the current period."
    - `character_count` integer — Use account_unit_count instead. Total characters used for this product in the current period."
  - `api_key_character_count` integer — Only present for API Pro users. Total characters used by this API key in the current period.
  - `api_key_character_limit` integer — Only present for API Pro users. Character limit for this API key in the current period.
  - `speech_to_text_milliseconds_count` integer — Deprecated. Always returns 0. Use speech_to_text_minutes_count instead.
  - `speech_to_text_milliseconds_limit` integer — Deprecated. Always returns 0. Use speech_to_text_minutes_limit instead.
  - `speech_to_text_minutes_count` integer — Only present for API Pro users. Minutes of speech-to-text used in the current period. Milliseconds are rounded up to the nearest minute.
  - `speech_to_text_minutes_limit` integer — Only present for API Pro users. Maximum minutes of speech-to-text that can be used in the current billing period.
  - `speech_to_speech_minutes_count` integer — Only present for API Pro users. Minutes of speech-to-speech used in the current period. Milliseconds are rounded up to the nearest minute.
  - `speech_to_speech_minutes_limit` integer — Only present for API Pro users. Maximum minutes of speech-to-speech that can be used in the current billing period.
  - `start_time` string, date-time — Only present for API Pro users. Start time of the current billing period (ISO 8601).
  - `end_time` string, date-time — Only present for API Pro users. End time of the current billing period (ISO 8601).

## 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. This error is also returned when the API key is scoped but does not include the scope required for this endpoint.
- `404` — The requested resource could not be found.
- `413` — The request size exceeds the limit.
- `429` — Too many requests. Please wait and resend your request.
- `456` — Quota exceeded. The character limit has been reached.
- `500` — Internal error.
- `504` — Resource currently unavailable. Try again later.
- `529` — Too many requests. Please wait and resend your request.

---

[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)