DEdeepl
MetaInformation

Retrieve Languages

Changed on

Returns languages supported by the specified DeepL API resource. Each language indicates whether it can be used as a source language, a target language, or both, along with the features it supports for that resource.

get/v3/languages

Request

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

Query parameters

resource'translate_text' | 'translate_document' | 'glossary' | 'voice' | 'write' | 'style_rules' | 'translation_memory' required

The resource to retrieve languages for. Supported values: translate_text, translate_document, glossary, voice, write, style_rules, translation_memory.

includestring[]

Controls which languages and features are included in the response. By default, only stable languages and features are returned. Values can be combined with repeated parameters (e.g. ?include=beta&include=external).

  • beta: Include languages and features in beta, in addition to stable
  • external: Include features that rely on third-party service providers

Response

JSON array where each item represents a supported language.

langstring required

The language code (BCP 47).

namestring required

Name of the language in English.

usable_as_sourceboolean required

Whether this language can be used as a source language with the specified resource.

usable_as_targetboolean required

Whether this language can be used as a target language with the specified resource.

status'stable' | 'beta' | 'early_access' required

Availability status of this language.

featuresobject required

Features supported for this language with the specified resource. Always present; empty object if no optional features are supported. Each key is a feature name; the value is an object with at least a status field. Consult GET /v3/languages/resources to determine whether a feature must be present on the source language, target language, or both for a given resource.

Example response

[
  {
    "lang": "de",
    "name": "German",
    "status": "stable",
    "features": {
      "formality": {
        "status": "stable"
      },
      "tag_handling": {
        "status": "stable"
      },
      "glossary": {
        "status": "stable"
      }
    }
  }
]

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