curl --request GET \
--url https://api.deepl.com/v3/languages \
--header 'Authorization: <api-key>'[
{
"lang": "de",
"name": "German",
"usable_as_source": true,
"usable_as_target": true,
"status": "stable",
"features": {
"formality": {
"status": "stable"
},
"tag_handling": {
"status": "stable"
},
"glossary": {
"status": "stable"
}
}
},
{
"lang": "en",
"name": "English",
"usable_as_source": true,
"usable_as_target": false,
"status": "stable",
"features": {
"tag_handling": {
"status": "stable"
},
"glossary": {
"status": "stable"
}
}
},
{
"lang": "en-US",
"name": "English (American)",
"usable_as_source": false,
"usable_as_target": true,
"status": "stable",
"features": {
"tag_handling": {
"status": "stable"
},
"glossary": {
"status": "stable"
}
}
}
]{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}Retrieve languages
Retrieve the languages a DeepL API resource supports, including source and target roles and per-resource features.
curl --request GET \
--url https://api.deepl.com/v3/languages \
--header 'Authorization: <api-key>'[
{
"lang": "de",
"name": "German",
"usable_as_source": true,
"usable_as_target": true,
"status": "stable",
"features": {
"formality": {
"status": "stable"
},
"tag_handling": {
"status": "stable"
},
"glossary": {
"status": "stable"
}
}
},
{
"lang": "en",
"name": "English",
"usable_as_source": true,
"usable_as_target": false,
"status": "stable",
"features": {
"tag_handling": {
"status": "stable"
},
"glossary": {
"status": "stable"
}
}
},
{
"lang": "en-US",
"name": "English (American)",
"usable_as_source": false,
"usable_as_target": true,
"status": "stable",
"features": {
"tag_handling": {
"status": "stable"
},
"glossary": {
"status": "stable"
}
}
}
]{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}Authorizations
Authentication with Authorization header and DeepL-Auth-Key authentication scheme. Example: DeepL-Auth-Key <api-key>
Query Parameters
The resource to retrieve languages for. Supported values: translate_text, translate_document,
glossary, voice, write, style_rules, translation_memory.
translate_text, translate_document, glossary, voice, write, style_rules, translation_memory 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 stableexternal: Include features that rely on third-party service providers
beta, external Response
JSON array where each item represents a supported language.
The language code (BCP 47).
"de"
Name of the language in English.
"German"
Whether this language can be used as a source language with the specified resource.
Whether this language can be used as a target language with the specified resource.
Availability status of this language.
stable, beta, early_access "stable"
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.
Show child attributes
Show child attributes
{
"formality": { "status": "stable" },
"tag_handling": { "status": "stable" },
"glossary": { "status": "stable" }
}