API reference for retrieving usage and quota for the current billing period with the DeepL API.
Retrieve usage information within the current billing period together with the corresponding account limits. For Pro API users, the /usage
endpoint returns the following:
/write
) characters consumed in the current billing period in total and for the API key used to make the requestapi_key_character_limit
field in the response; 1000000000000
will be returned if no key-level limit is set)character_limit
field in the response; 1000000000000
will be returned if no limit is set)An example request and response is shown below.
Note that responses for Free API and Pro Classic users only contain character_count
and character_limit
.
The value in the 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.
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.
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.
If you are looking for general API limitations, please see here.
API reference for retrieving usage and quota for the current billing period with the DeepL API.
Retrieve usage information within the current billing period together with the corresponding account limits. For Pro API users, the /usage
endpoint returns the following:
/write
) characters consumed in the current billing period in total and for the API key used to make the requestapi_key_character_limit
field in the response; 1000000000000
will be returned if no key-level limit is set)character_limit
field in the response; 1000000000000
will be returned if no limit is set)An example request and response is shown below.
Note that responses for Free API and Pro Classic users only contain character_count
and character_limit
.
The value in the 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.
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.
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.
If you are looking for general API limitations, please see here.