World Reference Data API

Countries, ISO 3166-2 subdivisions, currencies, IANA time zones with DST transitions, rule-computed public holidays with business-day maths, 8,900+ airports, languages and locales, calling codes, postal-code formats and ECB reference exchange rates — one key, one envelope.

Reference data developers otherwise stitch together from five sources, bundled at the edge and answered in milliseconds: ISO 3166-1 countries (codes, capital, coordinates, area, population, M49 region, currencies, calling code, TLD, languages, neighbours, weekend, postal-code format), 5,000+ ISO 3166-2 subdivisions, ISO 4217 currencies with minor units, every IANA time zone with current offset, DST transitions and conversions, public holidays computed from rules for 200+ countries with business-day checks, additions and counts, 8,900+ IATA airports with time zones, nearest-airport and great-circle distance, ISO 639 languages, BCP 47 locale facts, calling codes and the European Central Bank’s euro reference rates (cached ≥ 6 h, attributed).

Everything except the ECB rates is computed from bundled, licence-checked datasets (GeoNames CC BY 4.0, Unicode CLDR, IANA tz, OurAirports public domain, Wikidata CC0, date-holidays CC BY 3.0) — no third-party API sits in the request path, so answers are fast, deterministic for the same input and dataset version, and private. Sources and attribution: /attribution.

Endpoints (32)

Quick start

Example: GET /v1/countries

cURL

curl --request GET 'https://world-reference-data-api.p.rapidapi.com/v1/countries?continent=AF&locale=de' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: world-reference-data-api.p.rapidapi.com'

JavaScript (fetch)

const res = await fetch('https://world-reference-data-api.p.rapidapi.com/v1/countries?continent=AF&locale=de', {
  method: 'GET',
  headers: {
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    "X-RapidAPI-Host": "world-reference-data-api.p.rapidapi.com"
  },
});
const { success, data, error } = await res.json();

Python (requests)

import requests

resp = requests.request(
    "GET",
    "https://world-reference-data-api.p.rapidapi.com/v1/countries?continent=AF&locale=de",
    headers={"X-RapidAPI-Key":"YOUR_RAPIDAPI_KEY","X-RapidAPI-Host":"world-reference-data-api.p.rapidapi.com"},
    timeout=10,
)
print(resp.json())

Limits

Responses

Every response is JSON. Success: {"success":true,"data":…,"meta":{"request_id","ms","source"}}. Errors: {"success":false,"error":{"code","message","hint","docs_url","request_id"}} with a semantically correct HTTP status — see the error catalogue.

Version 1.0.0 · We never log request bodies, query values, headers or IP addresses.