Languages

GET https://api.vizvuz.com/v1/languages?type=source
GET https://api.vizvuz.com/v1/languages?type=target

The endpoint is the authoritative list. This page explains what is in it.

Source languages

curl "https://api.vizvuz.com/v1/languages?type=source" \
  -H "Authorization: Bearer vz_live_xxxxxxxx"

[
  { "language": "BG", "name": "Bulgarian" },
  { "language": "CS", "name": "Czech" },
  { "language": "DA", "name": "Danish" }
]

There are 36: BG, CS, DA, DE, EL, EN, ES, ET, FI, FR, GA, HR, HU, IS, IT, LT, LV, MT, NL, NB, PL, PT, RO, SK, SL, SV, UK, TR, RU, SR, BS, MK, SQ, CA, EU and GL.

Target languages

curl "https://api.vizvuz.com/v1/languages?type=target" \
  -H "Authorization: Bearer vz_live_xxxxxxxx"

[
  { "language": "EN-GB", "name": "British English", "supports_formality": false },
  { "language": "EN-US", "name": "American English", "supports_formality": false },
  { "language": "DE", "name": "German", "supports_formality": true }
]

There are 38: the 36 source languages, minus bare EN and PT, plus EN-GB, EN-US, PT-PT and PT-BR.

Regional variants

Only English and Portuguese have variants, because only there is the difference consistent enough to be worth a separate target.

As a source language you always send the base code: EN, not EN-GB.

Formality support

supports_formality tells you whether formality: "more" and "less" change anything. Sending formality for a language that does not support it is not an error unless you asked for more/less specifically — use prefer_more or prefer_less instead if you want the request to succeed either way. See Translate text.

Language detection

Omit source_lang and the engine detects it. The detected code comes back in detected_source_language for every translation. Detection is reliable from roughly twenty characters onward; below that, send source_lang yourself.

Codes we reject

An unknown or unsupported code answers 400 with invalid_target_lang or invalid_source_lang. Codes are normalised before validation: lower case is accepted, and an underscore is treated as a hyphen, so pt_br works.