# 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** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


#### 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** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


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

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


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

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


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

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


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

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


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

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


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

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


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

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


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

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.



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