DEdeepl
MetaInformation

Check Usage and Limits

Changed on

Retrieve character and minute usage for the current billing period together with the corresponding account limits. Poll this endpoint to track consumption and detect when an account is approaching its quota.

get/v2/usage

Request

  • Base URL
    https://api.deepl.com
  • URL
    https://api.deepl.com/v2/usage
  • Auth
    API key in header Authorization

Response

The account's usage and limits.

character_countinteger

Characters translated so far in the current billing period.

character_limitinteger

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.

document_countinteger

Documents translated so far in the current billing period. Only present for accounts with a document limit.

document_limitinteger

Current maximum number of documents that can be translated per billing period. Only present for accounts with a document limit.

team_document_countinteger

Documents translated by all users in the team so far in the current billing period. Only present for accounts with a team document limit.

team_document_limitinteger

Current maximum number of documents that can be translated by the team per billing period. Only present for accounts with a team document limit.

api_key_character_countinteger

Only present for API Pro users. Total characters used by this API key in the current period.

api_key_character_limitinteger

Only present for API Pro users. Character limit for this API key in the current period.

speech_to_text_milliseconds_countinteger

Deprecated. Always returns 0. Use speech_to_text_minutes_count instead.

speech_to_text_milliseconds_limitinteger

Deprecated. Always returns 0. Use speech_to_text_minutes_limit instead.

speech_to_text_minutes_countinteger

Only present for API Pro users. Minutes of speech-to-text used in the current period. Milliseconds are rounded up to the nearest minute.

speech_to_text_minutes_limitinteger

Only present for API Pro users. Maximum minutes of speech-to-text that can be used in the current billing period.

speech_to_speech_minutes_countinteger

Only present for API Pro users. Minutes of speech-to-speech used in the current period. Milliseconds are rounded up to the nearest minute.

speech_to_speech_minutes_limitinteger

Only present for API Pro users. Maximum minutes of speech-to-speech that can be used in the current billing period.

start_timestring date-time

Only present for API Pro users. Start time of the current billing period (ISO 8601).

end_timestring date-time

Only present for API Pro users. End time of the current billing period (ISO 8601).

Example response

{
  "character_count": 180118,
  "character_limit": 1250000,
  "products": [
    {
      "product_type": "write",
      "billing_unit": "characters",
      "account_unit_count": 5643,
      "character_count": 5643
    }
  ],
  "api_key_character_count": 636,
  "api_key_character_limit": 1000000000000,
  "speech_to_text_minutes_count": 30,
  "speech_to_text_minutes_limit": 600,
  "speech_to_speech_minutes_count": 12,
  "speech_to_speech_minutes_limit": 600,
  "start_time": "2025-05-13T09:18:42Z",
  "end_time": "2025-06-13T09:18:42Z"
}

Changes

  • c7c91cfac5c0Revision changes
    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status