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
}

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

Characters translated so far in the current billing period.

Example:

180118

​
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.

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

​
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"