v1

latestOpenAPI 3.0.32026-07-265278189.1 KB

MetaInformation

Retrieve Languages

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

Query parameters

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"
      }
    }
  }
]