← Docs

Language API

A language by ISO code, with name, script, and direction.

Pass en, ja, or gsw. The English name, the language's own name for itself, the script it writes in, and whether it reads left-to-right or right-to-left. Both code lengths work: /language/en and /language/eng return the same thing.

/country already returns languages as these codes. Come here for the full record.

Lookup

GET
api.parseapi.com/language/{code}
By ISO 639 code. Name, native name, script and direction
Explore
Parameters 3
codestring · path · required

ISO 639 language code, 2 or 3 letters

langstring · query · optional

Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.

deepboolean · query · optional

Three-letter code and associated countries. Included on every plan, with no additional charge.

Run uses the free demo on API 2.0.0. Copied code uses your API key when signed in, or YOUR_API_KEY when signed out.

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.language("en");
console.log(result);

Run on your server with a secret key. Calling from a browser or app?

Example response
{
  "language": "en",
  "name": "English",
  "name_local": null,
  "script": "Latn",
  "direction": "ltr"
}

Run uses the free demo on API 2.0.0. Copied code uses your API key when signed in, or YOUR_API_KEY when signed out.

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.language("ja");
console.log(result);

Run on your server with a secret key. Calling from a browser or app?

Example response
{
  "language": "ja",
  "name": "Japanese",
  "name_local": "日本語",
  "script": "Jpan",
  "direction": "ltr"
}

Run uses the free demo on API 2.0.0. Copied code uses your API key when signed in, or YOUR_API_KEY when signed out.

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.language("ar");
console.log(result);

Run on your server with a secret key. Calling from a browser or app?

Example response
{
  "language": "ar",
  "name": "Arabic",
  "name_local": "العربية",
  "script": "Arab",
  "direction": "rtl"
}

Response fields

language
BCP 47 shortest code. ISO 639-1 when it exists (en), ISO 639-3 otherwise (gsw)
name
English name
name_local
The language's own name for itself (日本語 for ja), null when absent or identical to name
script
ISO 15924 script code (Latn, Jpan, Arab)
direction
ltr or rtl

/language/eng resolves to the same en row.

Run uses the free demo on API 2.0.0. Copied code uses your API key when signed in, or YOUR_API_KEY when signed out.

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.language("eng");
console.log(result);

Run on your server with a secret key. Calling from a browser or app?

Example response
{
  "language": "en",
  "name": "English",
  "name_local": null,
  "script": "Latn",
  "direction": "ltr"
}

Deep

?deep=true Three-letter code and associated countries. Included on every plan, with no additional charge.

Run uses the free demo on API 2.0.0. Copied code uses your API key when signed in, or YOUR_API_KEY when signed out.

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.language("en", { deep: true });
console.log(result);

Run on your server with a secret key. Calling from a browser or app?

Example response
{
  "language": "en",
  "name": "English",
  "name_local": null,
  "script": "Latn",
  "direction": "ltr",
  "deep": {
    "iso3": "eng",
    "countries": [
      "AG",
      "AI",
      "AS",
      "AU",
      "BB"
    ]
  }
}

Deep fields

deep.iso3
ISO 639-3 code
deep.countries
ISO2 countries listing this language

Display language

Pass lang with a language tag such as fr, pt-BR, or zh-Hant. Language name. Each choice covers 194–206 of the 225 current language records.

Omitting lang preserves the original response. Codes, IDs, numeric facts and native-name fields stay unchanged. Missing translations keep their existing source value; unknown values stay null. A preserved name_local may equal the translated name.

Send a chosen browser preference explicitly, for example { lang: navigator.language } in your JavaScript SDK options. The API does not read Accept-Language automatically. Unsupported regions fall back to their supported base language; unsupported languages or scripts use English. Empty, invalid or repeated tags return 400.

Content-Language identifies languages used in translated display fields and known English fallbacks. This option follows the current API contract. Requests selecting frozen 1.0.0 retain that contract. Select API 2.0.0 to use display language.

41 display language choices
Language tagLanguage
enAmerican English
zh-Hans简体中文
frfrançais (France)
deDeutsch
ititaliano
ja日本語
ko한국어
esespañol de España
arالعربية
bgбългарски
cacatalà
hrhrvatski
csčeština
dadansk
nlNederlands
fisuomi
elΕλληνικά
heעברית
hiहिन्दी
humagyar
idIndonesia
kkқазақ тілі
msMelayu
nbnorsk bokmål
plpolski
ptportuguês (Brasil)
roromână
ruрусский
skslovenčina
svsvenska
thไทย
trTürkçe
ukукраїнська
viTiếng Việt
zh-Hant繁體中文
en-AUAustralian English
en-GBBritish English
fr-CAfrançais canadien
es-419español latinoamericano
pt-PTportuguês europeu
zh-Hant-HK繁體中文(中國香港特別行政區)

Questions? Email