Trusted by 40,000+ developers

Country data for everycorner of the globe

One simple REST API for names, codes, currencies, languages, capitals and flags of every nation. Built on the reliable country lookup API — drop it in and ship global features in minutes.

Start free Try the playground

No credit card required Free tier included Instant setup

250+

Countries covered

99.9%

Uptime SLA

<50ms

Median response

Features

Everything you need to go global

Stop maintaining country datasets by hand. Get accurate, up-to-date reference data through a single, well-documented endpoint.

Flags & names

Official names, common names and flag URLs for every country, ready to render anywhere.

Languages

Native language names and ISO codes so your UI can localize itself automatically.

Currencies

Currency codes, symbols and names to format prices correctly for any market.

Capitals & regions

Capital cities, subregions and continent data to power maps and filters.

Blazing fast

Edge-cached responses with a median latency under 50ms, globally.

Reliable & secure

99.9% uptime SLA, HTTPS everywhere and simple API keys for access control.

Live playground

See the response in real time

Type any country name or code and watch the API return rich, structured data instantly.

GET /v2/country/japan

Country name or code

?fullText=true?fields=name,capital

200 OK · 42ms

{
  "name": "Japan",
  "alpha2Code": "JP",
  "alpha3Code": "JPN",
  "capital": "Tokyo",
  "region": "Asia",
  "subregion": "Eastern Asia",
  "population": 125836021,
  "currencies": [
    {
      "code": "JPY",
      "name": "Japanese yen",
      "symbol": "¥"
    }
  ],
  "languages": [
    {
      "name": "Japanese"
    }
  ],
  "flag": "🇯🇵"
}

Endpoints

Simple, predictable routes

Every endpoint returns clean JSON you can trust. No pagination headaches, no undocumented fields.

Read full docs

GET/v2/all

List every country with full details in one call.

GET/v2/name/{name}

Search by common or official name, with fuzzy matching.

GET/v2/alpha/{code}

Look up by ISO 3166-1 alpha-2 or alpha-3 code.

GET/v2/currency/{currency}

Find all countries that use a given currency.

GET/v2/capital/{capital}

Search by capital city name.

GET/v2/region/{region}

Filter countries by continent or region.

JavaScript

const res = await fetch(
  "https://api.countrylayer.com/v2/name/japan?access_key=YOUR_KEY"
);
const country = await res.json();

console.log(country[0].capital); // "Tokyo"
console.log(country[0].currencies[0].code); // "JPY"

Pricing