Skip to main content
Get the complete list of languages supported for translation. Optionally get language names translated into a target language.
Endpoint
GET /translate/v1/languages
curl https://api.case.dev/translate/v1/languages \
  -H "Authorization: Bearer sk_case_YOUR_API_KEY"
casedev translate:v1 list-languages
import Casedev from 'casedev';

const client = new Casedev({ apiKey: 'sk_case_YOUR_API_KEY' });

const result = await client.translate.v1.languages();

result.data.languages.forEach(lang => {
  console.log(lang.language);
});
// "en", "es", "fr", "de", ...
import casedev

client = casedev.Casedev(api_key='sk_case_YOUR_API_KEY')

result = client.translate.v1.list_languages()

for lang in result.data.languages:
    print(lang.language)
# "en", "es", "fr", "de", ...
result, _ := client.Translate.V1.ListLanguages(ctx, casedev.TranslateV1ListLanguagesParams{})
for _, lang := range result.Data.Languages {
	fmt.Printf("%s (%s)\n", lang.Name, lang.Language)
}
Response
{
  "data": {
    "languages": [
      { "language": "af" },
      { "language": "ar" },
      { "language": "az" },
      { "language": "be" },
      { "language": "bg" },
      { "language": "bn" },
      ...
    ]
  }
}

Query parameters

ParameterTypeDescription
targetstringTarget language for translating language names
modelstringModel to check support for: nmt or base

Get localized language names

Include language names translated into a specific language:
curl "https://api.case.dev/translate/v1/languages?target=es" \
  -H "Authorization: Bearer sk_case_YOUR_API_KEY"
casedev translate:v1 list-languages
const result = await client.translate.v1.languages({
  target: 'es'  // Get names in Spanish
});

result.data.languages.forEach(lang => {
  console.log(`${lang.language}: ${lang.name}`);
});
// "en: Inglés"
// "es: Español"
// "fr: Francés"
// "de: Alemán"
result = client.translate.v1.list_languages(target="es")

for lang in result.data.languages:
    print(f"{lang.language}: {lang.name}")
# "en: Inglés"
# "es: Español"
result, _ := client.Translate.V1.ListLanguages(ctx, casedev.TranslateV1ListLanguagesParams{})
for _, lang := range result.Data.Languages {
	fmt.Printf("%s (%s)\n", lang.Name, lang.Language)
}
Response with names
{
  "data": {
    "languages": [
      { "language": "en", "name": "Inglés" },
      { "language": "es", "name": "Español" },
      { "language": "fr", "name": "Francés" },
      { "language": "de", "name": "Alemán" },
      { "language": "zh", "name": "Chino" },
      ...
    ]
  }
}
CodeLanguage
enEnglish
esSpanish
frFrench
deGerman
itItalian
ptPortuguese
ruRussian
zhChinese (Simplified)
zh-TWChinese (Traditional)
jaJapanese
koKorean
arArabic
hiHindi
thThai
viVietnamese
nlDutch
plPolish
trTurkish
ukUkrainian
heHebrew

Examples

Build a language selector

casedev translate:v1 list-languages --target en
const result = await client.translate.v1.languages({
  target: 'en'  // Get English names
});

const languageOptions = result.data.languages.map(lang => ({
  value: lang.language,
  label: lang.name
}));

// Use in a dropdown component
<Select options={languageOptions} />
result = client.translate.v1.list_languages(target='en')

language_options = [
    {'value': lang.language, 'label': lang.name}
    for lang in result.data.languages
]

# Use in a dropdown component
result, _ := client.Translate.V1.ListLanguages(ctx, casedev.TranslateV1ListLanguagesParams{
	Target: casedev.F("en"),
})

for _, lang := range result.Data.Languages {
	fmt.Printf("value: %s, label: %s\n", lang.Language, lang.Name)
}

Check if a language is supported

casedev translate:v1 list-languages
const result = await client.translate.v1.languages();
const supportedCodes = new Set(
  result.data.languages.map(l => l.language)
);

function isSupported(langCode: string): boolean {
  return supportedCodes.has(langCode);
}

console.log(isSupported('es')); // true
console.log(isSupported('xyz')); // false
result = client.translate.v1.list_languages()
supported_codes = {lang.language for lang in result.data.languages}

def is_supported(lang_code: str) -> bool:
    return lang_code in supported_codes

print(is_supported('es'))   # True
print(is_supported('xyz'))  # False
result, _ := client.Translate.V1.ListLanguages(ctx, casedev.TranslateV1ListLanguagesParams{})
supported := make(map[string]bool)
for _, lang := range result.Data.Languages {
	supported[lang.Language] = true
}

fmt.Println(supported["es"])  // true
fmt.Println(supported["xyz"]) // false
Pricing: This endpoint is free and does not count toward usage.