/usage
endpoint returns the following:
- Text and document translation characters consumed in the current billing period in total and for the API key used to make the request
- Text improvement (
/write
) characters consumed in the current billing period in total and for the API key used to make the request - Total characters consumed in the current billing period by the API key used to make the request
- The key-level character limit for the API key used to make the request, if applicable (if a key-level usage limit is set, it will be reflected in the
api_key_character_limit
field in the response;1000000000000
will be returned if no key-level limit is set) - The current billing period start timestamp
- The current billing period end timestamp
- Total characters consumed in the current billing period
- Subscription-level character limit that applies to the current billing period (if Cost Control is set, it will be reflected in the
character_limit
field in the response;1000000000000
will be returned if no limit is set)
Note that responses for Free API and Pro Classic users only contain
character_count
and character_limit
.character_count
field includes both text and document translations as well as text improvement (DeepL API for Write) characters. Characters are counted based on the source text length in Unicode code points, so for example “A”, “Δ”, “あ”, and “深” are each counted as a single character.
We also provide a spec that is auto-generated from DeepL’s OpenAPI file. You can find it here.
The example below uses our API Pro endpoint
https://api.deepl.com
. If you’re an API Free user, remember to update your requests to use https://api-free.deepl.com
instead.Example request: check usage and limits
Example response