Check Usage and Limits
curl --request GET \
--url https://api.deepl.com/v2/usage \
--header 'Authorization: <api-key>'{
"character_count": 180118,
"character_limit": 1250000
}Usage & Quota
Check usage and limits
Retrieve near-real-time character usage and account limits for the current billing period.
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 onlycharacter_countandcharacter_limit. character_countsums 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_limitreflects a Cost Control limit if one is set;api_key_character_limitreflects a key-level usage limit if one is set. Both fields return1000000000000when no limit is configured.
Authorizations
Response
The account's usage and limits.