Skip to main content
GET
/
v1
/
languages
List Languages
curl --request GET \
  --url https://api.example.com/v1/languages
{
  "data": [
    {
      "id": 123,
      "glottocode": "<string>",
      "iso639_3": "<string>",
      "name": "<string>",
      "level": "<string>"
    }
  ],
  "meta": {
    "total": 123,
    "limit": 123,
    "offset": 123
  }
}

​
Request

GET https://api.langdex.co/v1/languages

​
Query Parameters

​
limit
integer
default:"50"
Maximum number of results (1-100)
​
offset
integer
default:"0"
Number of results to skip
​
level
string
Filter by level: family, language, or dialect
​
family
string
Filter by language family Glottocode
​
has_iso
boolean
Only return languages with ISO 639-3 codes
​
include
string
Include related data: scripts, names, family

​
Response

​
data
array
Array of language objects
​
meta
object
Pagination metadata

​
Examples

​
List all languages

curl "https://api.langdex.co/v1/languages?limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "data": [
    {
      "id": 1,
      "glottocode": "afro1255",
      "iso639_3": null,
      "name": "Afro-Asiatic",
      "level": "family"
    },
    {
      "id": 2,
      "glottocode": "arab1395",
      "iso639_3": "ara",
      "name": "Arabic",
      "level": "language"
    }
  ],
  "meta": {
    "total": 7234,
    "limit": 10,
    "offset": 0
  }
}

​
List languages in a family

curl "https://api.langdex.co/v1/languages?family=indo1319&level=language" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

{
  "data": [
    {
      "id": 123,
      "glottocode": "nucl1643",
      "name": "Japanese",
      "level": "language",
      "scripts": ["Jpan", "Hira", "Kana", "Latn"],
      "family": {
        "glottocode": "japo1237",
        "name": "Japonic"
      }
    }
  ]
}