Skip to main content
GET
/
v2
/
usage
Check Usage and Limits
curl --request GET \
  --url https://api.deepl.com/v2/usage \
  --header 'Authorization: <api-key>'
{
  "character_count": 180118,
  "character_limit": 1250000,
  "products": [
    {
      "product_type": "write",
      "billing_unit": "characters",
      "api_key_unit_count": 0,
      "account_unit_count": 5643,
      "api_key_character_count": 0,
      "character_count": 5643
    }
  ],
  "api_key_character_count": 636,
  "api_key_character_limit": 1000000000000,
  "speech_to_text_milliseconds_count": 1800000,
  "speech_to_text_milliseconds_limit": 36000000,
  "start_time": "2025-05-13T09:18:42Z",
  "end_time": "2025-06-13T09:18:42Z"
}

Authorizations

​
Authorization
string
header
required

Authentication with Authorization header and DeepL-Auth-Key authentication scheme. Example: DeepL-Auth-Key <api-key>

Response

The account's usage and limits.

​
character_count
integer<int64>

Characters translated so far in the current billing period.

Example:

180118

​
character_limit
integer<int64>

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.

Example:

1250000

​
products
object[]

Only present for API Pro users. Per-product usage details.

​
api_key_character_count
integer

Only present for API Pro users. Total characters used by this API key in the current period.

Example:

636

​
api_key_character_limit
integer

Only present for API Pro users. Character limit for this API key in the current period.

Example:

1000000000000

​
speech_to_text_milliseconds_count
integer

Only present for API Pro users. Milliseconds of speech-to-text used in the current period.

Example:

1800000

​
speech_to_text_milliseconds_limit
integer

Only present for API Pro users. Milliseconds of speech-to-text limit in the current period.

Example:

36000000

​
start_time
string<date-time>

Only present for API Pro users. Start time of the current billing period (ISO 8601).

Example:

"2025-05-13T09:18:42Z"

​
end_time
string<date-time>

Only present for API Pro users. End time of the current billing period (ISO 8601).

Example:

"2025-06-13T09:18:42Z"