Check Usage and Limits | Deepl API documentation

Check Usage and Limits Run in API Explorer

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://bump.sh/polo/hub/about-mcp/doc/deepl/mcp

Standard setup for AI tools providing an mcp.json file

{
  "Deepl MCP server": {
    "url": "https://bump.sh/polo/hub/about-mcp/doc/deepl/mcp"
  }
}

GET /v2/usage

Auth header

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.

Responses

200 application/json

The account's usage and limits.
Hide headers attribute Show headers attribute
- X-Trace-ID
  
  A unique identifier for the request that can be included in bug reports to DeepL support.
Hide response attributes Show response attributes 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.
  
  Hide products attributes Show products attributes object
  
  product_type string
  
  The type of product (e.g., 'write', 'translate').
  
  billing_unit string
  
  The billing unit for this product type.
  
  Values are characters or milliseconds.
  
  api_key_unit_count integer
  
  Units used for this product by this API key in the current period.
  
  account_unit_count integer
  
  Total units used for this product by the account in the current period.
  
  api_key_character_count integer
  
  Characters used for this product by this API key in the current period.
  
  character_count integer
  
  Total characters used for this product in the current period.
- 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.
Hide headers attribute Show headers attribute
- 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.
Hide headers attribute Show headers attribute
- 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.
Hide headers attribute Show headers attribute
- 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.
Hide headers attribute Show headers attribute
- 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.
Hide headers attribute Show headers attribute
- 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.
Hide headers attribute Show headers attribute
- X-Trace-ID
  
  A unique identifier for the request that can be included in bug reports to DeepL support.
500

Internal error.
Hide headers attribute Show headers attribute
- 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.
Hide headers attribute Show headers attribute
- 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.
Hide headers attribute Show headers attribute
- X-Trace-ID
  
  A unique identifier for the request that can be included in bug reports to DeepL support.

GET /v2/usage

curl \
 --request GET 'https://api.deepl.com/v2/usage' \
 --header "Authorization: $API_KEY"

Response examples (200)

{
  "character_count": 180118,
  "character_limit": 1250000
}

{
  "character_count": 5947223,
  "character_limit": 1000000000000,
  "products": [
    {
      "product_type": "write",
      "billing_unit": "characters",
      "api_key_unit_count": 0,
      "account_unit_count": 5643,
      "api_key_character_count": 0,
      "character_count": 5643
    },
    {
      "product_type": "translate",
      "billing_unit": "characters",
      "api_key_unit_count": 636,
      "account_unit_count": 5941580,
      "api_key_character_count": 636,
      "character_count": 5941580
    },
    {
      "product_type": "speech_to_text",
      "billing_unit": "milliseconds",
      "api_key_unit_count": 1800000,
      "account_unit_count": 1800000,
      "api_key_character_count": 0,
      "character_count": 0
    }
  ],
  "api_key_character_count": 636,
  "api_key_character_limit": 1000000000000,
  "speech_to_text_milliseconds_count": 1800000,
  "speech_to_text_milliseconds_limit": 36000000,
  "start_time": "2025-05-13T09:18:42Z",
  "end_time": "2025-06-13T09:18:42Z"
}