Skip to main content
GET
/
v1
/
languages
/
{id}
Get Language
curl --request GET \
  --url https://api.example.com/v1/languages/{id}
{
  "id": 123,
  "glottocode": "<string>",
  "iso639_3": "<string>",
  "name": "<string>",
  "level": "<string>",
  "parent_glottocode": "<string>",
  "latitude": 123,
  "longitude": 123,
  "speakers": 123,
  "status": "<string>"
}

​
Request

GET https://api.langdex.co/v1/languages/{id}

​
Path Parameters

​
id
string
required
Glottocode (e.g., nucl1643) or numeric ID

​
Query Parameters

​
include
string
Include related data: scripts, names, family, children

​
Response

​
id
integer
Internal LangDex ID
​
glottocode
string
Unique Glottolog identifier (8 characters)
​
iso639_3
string
ISO 639-3 code (3 characters, if exists)
​
name
string
Primary English name
​
level
string
Hierarchy level: family, language, or dialect
​
parent_glottocode
string
Parent language/family Glottocode
​
latitude
number
Geographic center latitude
​
longitude
number
Geographic center longitude
​
speakers
integer
Estimated number of speakers
​
status
string
Endangerment status

​
Examples

​
Get by Glottocode

curl "https://api.langdex.co/v1/languages/nucl1643" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "id": 1234,
  "glottocode": "nucl1643",
  "iso639_3": "jpn",
  "name": "Japanese",
  "level": "language",
  "parent_glottocode": "japo1237",
  "latitude": 35.68,
  "longitude": 139.77,
  "speakers": 125000000,
  "status": "safe"
}

curl "https://api.langdex.co/v1/languages/nucl1643?include=scripts,names,family" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": 1234,
  "glottocode": "nucl1643",
  "iso639_3": "jpn",
  "name": "Japanese",
  "level": "language",
  "scripts": [
    {"code": "Jpan", "name": "Japanese"},
    {"code": "Hira", "name": "Hiragana"},
    {"code": "Kana", "name": "Katakana"},
    {"code": "Latn", "name": "Latin"}
  ],
  "names": [
    {"locale": "en", "name": "Japanese"},
    {"locale": "ja", "name": "日本語", "is_native": true},
    {"locale": "de", "name": "Japanisch"},
    {"locale": "fr", "name": "japonais"}
  ],
  "family": {
    "glottocode": "japo1237",
    "name": "Japonic"
  }
}

​
Get by ISO code

You can also look up by ISO 639-3 code: 
curl "https://api.langdex.co/v1/languages/iso/jpn" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Error Responses

​
404 Not Found

{
  "error": {
    "code": "not_found",
    "message": "Language not found: xyz12345"
  }
}