> For the complete documentation index, see [llms.txt](https://doc.bodinat.de/doc/deepl/llms.txt)

# Check Usage and Limits

> GET /v2/usage
> 
> Retrieve usage information within the current billing period together with the corresponding account limits. Usage is returned for:
> - translated characters
> - translated documents
> - translated documents, team totals (for team accounts only)
> 
> Character usage includes both text and document translations, and is measured by the source text length in Unicode code points,
> so for example "A", "Δ", "あ", and "深" are each counted as a single character.
> 
> Document usage only includes document translations, and is measured in individual documents.
> 
> Depending on the user account type, some usage types will be omitted.
> Character usage is only included for developer accounts.
> Document usage is only included for non-developer accounts, and team-combined document usage is only included for non-developer team accounts.



## Servers
- DeepL API Pro: https://api.deepl.com (DeepL API Pro)
- DeepL API Free: https://api-free.deepl.com (DeepL API Free)


## Authentication methods
- Auth header


## Parameters




## Responses
### 200
The account's usage and limits.
#### Headers

- **X-Trace-ID** ()


#### Body: application/json (object)
- **character_count** (integer(int64))
  Characters translated so far in the current billing period.

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

- **products** (array[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.

- **api_key_character_limit** (integer)
  Only present for API Pro users. Character limit for this API key in the current period.

- **speech_to_text_milliseconds_count** (integer)
  Only present for API Pro users. Milliseconds of speech-to-text used in the current period.

- **speech_to_text_milliseconds_limit** (integer)
  Only present for API Pro users. Milliseconds of speech-to-text limit in the current period.

- **start_time** (string(date-time))
  Only present for API Pro users. Start time of the current billing period (ISO 8601).

- **end_time** (string(date-time))
  Only present for API Pro users. End time of the current billing period (ISO 8601).


### 400
Bad request. Please check error message and your parameters.
#### Headers

- **X-Trace-ID** ()


### 403
Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header.
#### Headers

- **X-Trace-ID** ()


### 404
The requested resource could not be found.
#### Headers

- **X-Trace-ID** ()


### 413
The request size exceeds the limit.
#### Headers

- **X-Trace-ID** ()


### 429
Too many requests. Please wait and resend your request.
#### Headers

- **X-Trace-ID** ()


### 456
Quota exceeded. The character limit has been reached.
#### Headers

- **X-Trace-ID** ()


### 500
Internal error.
#### Headers

- **X-Trace-ID** ()


### 504
Resource currently unavailable. Try again later.
#### Headers

- **X-Trace-ID** ()


### 529
Too many requests. Please wait and resend your request.
#### Headers

- **X-Trace-ID** ()



[Powered by Bump.sh](https://bump.sh)
