Languages · Data API

World Language Codes

Standard two-letter codes for the world's languages and their English names.

The ISO 639-1 list of two-letter language codes mapped to their English language names. Developers use it for localisation, translation pipelines, content tagging and letting AI agents validate or convert language identifiers.

Source: datasets/language-codes (ISO 639-1 via Library of Congress) · ODC-PDDL-1.0 · Language code data from the datasets/language-codes project (github.com/datasets), based on ISO 639 lists published by the Library of Congress

Endpoints

Every request is authenticated with your X-API-Key and counted against your plan.

  • GET /v1/data/world-language-codes
  • GET /v1/data/world-language-codes/search?q=...
  • GET /v1/data/world-language-codes/{key}

Base path /v1/data/world-language-codes · full reference in the interactive docs. Also exposed as an MCP tool for AI agents.

Fields

FieldTypeDescription
alpha2strISO 639-1 two-letter language code
englishstrEnglish name of the language

What you get

Full ISO 639-1 two-letter code list
Code-to-name lookup
Name search to find a code
Lightweight reference for input validation

FAQ

Does it include three-letter codes?
This endpoint serves the two-letter ISO 639-1 codes only.
Are language names localised?
Names are provided in English.

Pricing

Simple, transparent pricing

Start free, upgrade when you need more. All plans include full API access.

Free

$0forever

Get started and explore the API

100 requests/day
  • 100 API requests per day
  • All endpoints included
  • Community support
Most popular

Pro

$9/month

For production apps and AI agents

10,000 requests/day
  • 10,000 API requests per day
  • All endpoints included
  • Priority support
  • Usage dashboard

Enterprise

$49/month

Unlimited access for high-volume use

Unlimited requests
  • Unlimited API requests
  • All endpoints included
  • Priority support
  • Usage dashboard
  • Dedicated support channel

Getting Started

Start building in minutes

Register for a free API key, make your first request, and upgrade when you're ready.

1

Register

Create an account to get your API key. It's free — no credit card required.

curl -X POST https://api.aristocles.com.au/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "name": "Your Name"}'
2

Make a request

Use your API key in the X-API-Key header to authenticate requests.

curl https://api.aristocles.com.au/v1/data/asx \
  -H "X-API-Key: your_api_key_here"
3

Upgrade

Need more requests? Upgrade to Pro or Enterprise — you'll be redirected to Stripe Checkout.

curl -X POST "https://api.aristocles.com.au/v1/billing/checkout?tier=pro" \
  -H "X-API-Key: your_api_key_here"
4

Check usage

Monitor your daily request count and remaining quota at any time.

curl https://api.aristocles.com.au/v1/usage \
  -H "X-API-Key: your_api_key_here"