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
}
Returns usage within the current billing period together with the corresponding limits. Data is near-real-time: typically up to date within a few minutes of the usage being generated. Response behavior the schema alone doesn’t convey:
  • For Pro API accounts, the response breaks usage down by product (translate, write) and reports both account totals and counts for the API key used to make the request. Responses for Free API and Pro Classic accounts contain only character_count and character_limit.
  • character_count sums text translation, document translation, and text improvement characters. Characters are counted from the source text length in Unicode code points, so “A”, “Δ”, “あ”, and “深” each count as one character.
  • character_limit reflects a Cost Control limit if one is set; api_key_character_limit reflects a key-level usage limit if one is set. Both fields return 1000000000000 when no limit is configured.
For usage data beyond the current billing period, or broken down by key or custom tag, see Retrieving Usage Data. For general API limitations, see Usage limits.

Authorizations

​
Authorization
string
header
default:DeepL-Auth-Key
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
deprecated

Deprecated. Always returns 0. Use speech_to_text_minutes_count instead.

Example:

0

​
speech_to_text_milliseconds_limit
integer
deprecated

Deprecated. Always returns 0. Use speech_to_text_minutes_limit instead.

Example:

0

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

Example:

30

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

Example:

600

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