Retrieve languages

API reference for retrieving supported languages with the DeepL API.

Get all currently supported source and target languages that can be used for text and document translation.

As of July 2024, Arabic (AR) and traditional Chinese (ZH-HANT) are supported for text translation but are not yet supported for document translation. Therefore, these languages have not yet been added to the /languages endpoint. We will add these languages to the /languages endpoint where appropriate after document translation support is added.

To get languages available for glossaries, please see here.

We also provide a spec that is auto-generated from DeepL's OpenAPI file. You can find it here.

To understand how we'll update the /languages endpoint when we add translation support for a new language or language variant, please see this article.

cURL

The example below uses our API Pro endpoint https://api.deepl.com. If you're an API Free user, remember to update your requests to use https://api-free.deepl.com instead.

Example request: supported target languages

curl -X GET 'https://api.deepl.com/v2/languages?type=target' \
--header 'Authorization: DeepL-Auth-Key [yourAuthKey]'

Example response

[
  {
    "language": "BG",
    "name": "Bulgarian",
    "supports_formality": false
  },
  {
    "language": "CS",
    "name": "Czech",
    "supports_formality": false
  },
  {
    "language": "DA",
    "name": "Danish",
    "supports_formality": false
  },
  {
    "language": "DE",
    "name": "German",
    "supports_formality": true
  },
  {
    "language": "EL",
    "name": "Greek",
    "supports_formality": false
  },
  {
    "language": "EN-GB",
    "name": "English (British)",
    "supports_formality": false
  },
  {
    "language": "EN-US",
    "name": "English (American)",
    "supports_formality": false
  },
  {
    "language": "ES",
    "name": "Spanish",
    "supports_formality": true
  },
  {
    "language": "ET",
    "name": "Estonian",
    "supports_formality": false
  },
  {
    "language": "FI",
    "name": "Finnish",
    "supports_formality": false
  },
  {
    "language": "FR",
    "name": "French",
    "supports_formality": true
  },
  {
    "language": "HU",
    "name": "Hungarian",
    "supports_formality": false
  },
  {
    "language": "ID",
    "name": "Indonesian",
    "supports_formality": false
  },
  {
    "language": "IT",
    "name": "Italian",
    "supports_formality": true
  },
  {
    "language": "JA",
    "name": "Japanese",
    "supports_formality": true
  },
  {
    "language": "KO",
    "name": "Korean",
    "supports_formality": false
  },
  {
    "language": "LT",
    "name": "Lithuanian",
    "supports_formality": false
  },
  {
    "language": "LV",
    "name": "Latvian",
    "supports_formality": false
  },
  {
    "language": "NB",
    "name": "Norwegian (Bokmål)",
    "supports_formality": false
  },
  {
    "language": "NL",
    "name": "Dutch",
    "supports_formality": true
  },
  {
    "language": "PL",
    "name": "Polish",
    "supports_formality": true
  },
  {
    "language": "PT-BR",
    "name": "Portuguese (Brazilian)",
    "supports_formality": true
  },
  {
    "language": "PT-PT",
    "name": "Portuguese (European)",
    "supports_formality": true
  },
  {
    "language": "RO",
    "name": "Romanian",
    "supports_formality": false
  },
  {
    "language": "RU",
    "name": "Russian",
    "supports_formality": true
  },
  {
    "language": "SK",
    "name": "Slovak",
    "supports_formality": false
  },
  {
    "language": "SL",
    "name": "Slovenian",
    "supports_formality": false
  },
  {
    "language": "SV",
    "name": "Swedish",
    "supports_formality": false
  },
  {
    "language": "TR",
    "name": "Turkish",
    "supports_formality": false
  },
  {
    "language": "UK",
    "name": "Ukrainian",
    "supports_formality": false
  },
  {
    "language": "ZH",
    "name": "Chinese (simplified)",
    "supports_formality": false
  },
  {
    "language": "ZH-HANS",
    "name": "Chinese (simplified)",
    "supports_formality": false
  }
]

HTTP Request

Example request: supported target languages

GET /v2/languages?type=target HTTP/2
Host: api.deepl.com
Authorization: DeepL-Auth-Key [yourAuthKey] 
User-Agent: YourApp/1.2.3

Example response

[
  {
    "language": "BG",
    "name": "Bulgarian",
    "supports_formality": false
  },
  {
    "language": "CS",
    "name": "Czech",
    "supports_formality": false
  },
  {
    "language": "DA",
    "name": "Danish",
    "supports_formality": false
  },
  {
    "language": "DE",
    "name": "German",
    "supports_formality": true
  },
  {
    "language": "EL",
    "name": "Greek",
    "supports_formality": false
  },
  {
    "language": "EN-GB",
    "name": "English (British)",
    "supports_formality": false
  },
  {
    "language": "EN-US",
    "name": "English (American)",
    "supports_formality": false
  },
  {
    "language": "ES",
    "name": "Spanish",
    "supports_formality": true
  },
  {
    "language": "ET",
    "name": "Estonian",
    "supports_formality": false
  },
  {
    "language": "FI",
    "name": "Finnish",
    "supports_formality": false
  },
  {
    "language": "FR",
    "name": "French",
    "supports_formality": true
  },
  {
    "language": "HU",
    "name": "Hungarian",
    "supports_formality": false
  },
  {
    "language": "ID",
    "name": "Indonesian",
    "supports_formality": false
  },
  {
    "language": "IT",
    "name": "Italian",
    "supports_formality": true
  },
  {
    "language": "JA",
    "name": "Japanese",
    "supports_formality": true
  },
  {
    "language": "KO",
    "name": "Korean",
    "supports_formality": false
  },
  {
    "language": "LT",
    "name": "Lithuanian",
    "supports_formality": false
  },
  {
    "language": "LV",
    "name": "Latvian",
    "supports_formality": false
  },
  {
    "language": "NB",
    "name": "Norwegian (Bokmål)",
    "supports_formality": false
  },
  {
    "language": "NL",
    "name": "Dutch",
    "supports_formality": true
  },
  {
    "language": "PL",
    "name": "Polish",
    "supports_formality": true
  },
  {
    "language": "PT-BR",
    "name": "Portuguese (Brazilian)",
    "supports_formality": true
  },
  {
    "language": "PT-PT",
    "name": "Portuguese (European)",
    "supports_formality": true
  },
  {
    "language": "RO",
    "name": "Romanian",
    "supports_formality": false
  },
  {
    "language": "RU",
    "name": "Russian",
    "supports_formality": true
  },
  {
    "language": "SK",
    "name": "Slovak",
    "supports_formality": false
  },
  {
    "language": "SL",
    "name": "Slovenian",
    "supports_formality": false
  },
  {
    "language": "SV",
    "name": "Swedish",
    "supports_formality": false
  },
  {
    "language": "TR",
    "name": "Turkish",
    "supports_formality": false
  },
  {
    "language": "UK",
    "name": "Ukrainian",
    "supports_formality": false
  },
  {
    "language": "ZH",
    "name": "Chinese (simplified)",
    "supports_formality": false
  },
  {
    "language": "ZH-HANS",
    "name": "Chinese (simplified)",
    "supports_formality": false
  }
]

Query parameters

Query parameter	Description
type (optional)	Supported values are source or target. If type parameter is not included, defaults to source. Type: enum