A code or name for the country record. /states for every state or province in it.

Either. /country/us and /country/usa are the same record.

Yes. /country/germany and /country/deutschland resolve. Accents are optional, cote divoire finds Ivory Coast.

Capital, currency, languages, borders, timezones, week start, driving side, plug types with voltage, emergency numbers, postal format, the national tax and its rate, and the IOC, FIFA, and plate codes. 41 fields.

What is the tax field?

The national sales tax by its local name. Germany answers VAT at 19. Japan answers Consumption tax at 10. The US answers null, there is no national sales tax.

What the country calls itself. Japan is Japan. local_name reads 日本.

How do I list states?

GET /country/{code}/states. Every admin division in that country.

GET /country/{code} · /{code}/states

Country API

Pass US, USA, or germany. Currency, timezones, plugs, tax, emergency numbers.

You have a code or a name. Currency, tax, plugs, emergency numbers.

name

Common name

capital

Capital city

currency

ISO currency code

languages

ISO 639 language codes. Expand each at /language/{code}

borders

Neighboring country ISO2 codes

timezones

IANA timezone ids used in the country. The US lists 29

week_start

First day of the week (monday, sunday, saturday)

units

Measurement system (metric or imperial)

driving_side

left or right

plugs

Power plug types, IEC letters (A through O)

voltage

Residential mains voltage. Null when no single standard exists

emergency

Emergency numbers: police, ambulance, fire. Null when not confirmed

postal_format

Postal code mask, # is a digit and A is a letter. Null when the country has no postal codes

tax

National sales tax name (VAT, GST). Null when there is none, like the US

tax_rate

Standard rate as a percent (19, 8.1)

ioc

Olympic committee code (GER, NED, SUI)

plate

International vehicle plate code (D, UK, CH)

states

Every state or province in the country

Pass a code or the name

/country/us, /country/usa, and /country/germany are the same lookup. Accents optional.

Get the facts

Capital, currency, languages, borders, timezones, week start, driving side, plugs and voltage, emergency numbers, postal format, the tax and its rate.

List the states

GET /country/{code}/states.

250 countries.

41 fields each. Every plan.

41
fields a record: 156
currencies covered: 229
with a states list: Code or name
same record

Look up a country by ISO2, ISO3, or its name. /country/us, /country/usa, and /country/united states return the same record, and accents are optional. name is English, local_name is the endonym, Japan's local_name reads 日本. languages is a list of ISO 639 codes, expand each one at /language/{code}.

Every record carries the practical facts. IANA timezones, first day of the week, metric or imperial, driving side, plug types with voltage and frequency, emergency numbers, postal code format with a ready regex, the national sales tax with its rate and id format, and the IOC, FIFA, and vehicle plate codes.

Official country records. Need states or regions too? Use /country/{code}/states. Feeds dropdowns, checkout forms, localized content, and shipping rules that vary by region.

RESPONSE

$ curl "https://api.parseapi.com/country/us" \
  -H "X-API-Key: YOUR_API_KEY"

// 200 · ~35ms US · ~97ms worldwide
{
  "country": "US",
  "iso3": "USA",
  "numeric": 840,
  "name": "United States",
  "full_name": "United States of America",
  "local_name": "United States",
  "demonym": "American",
  "capital": "Washington, D.C.",
  "capital_lat": 38.89,
  "capital_lon": -77.05,
  "continent": "NA",
  "region": "Americas",
  "subregion": "Northern America",
  "population": 340110988,
  "area": 9629091,
  "currency": "USD",
  "currency_name": "United States Dollar",
  "currency_symbol": "$",
  "tld": ".us",
  "calling_code": "+1",
  "emoji": "🇺🇸",
  "languages": ["en"],
  "borders": ["CA", "MX"],
  "blocs": ["G7", "NATO", "OECD"],
  "timezones": [
    "America/Adak",
    "America/Anchorage",
    "America/Boise",
    "America/Chicago",
    // ... 25 more
  ],
  "week_start": "sunday",
  "units": "imperial",
  "driving_side": "right",
  "plugs": ["A", "B"],
  "voltage": 120,
  "frequency": 60,
  "emergency": {
    "police": "911",
    "ambulance": "911",
    "fire": "911"
  },
  "postal_format": "#####",
  "postal_regex": "^(?:(\d{5})(?:[ \-](\d{4}))?)$",
  "tax": null,
  "tax_rate": null,
  "tax_id_format": null,
  "tax_id_regex": null,
  "ioc": "USA",
  "fifa": "USA",
  "plate": "USA"
}

Response fields

country: ISO2 country code
iso3: Three-letter country code
numeric: UN numeric code
name: Common name
full_name: Official long name
local_name: Local-language name
demonym: Demonym
capital: Capital city
capital_lat: Capital latitude (null when there is no capital)
capital_lon: Capital longitude (null when there is no capital)
continent: Continent code (NA, EU, AF, AS, OC, SA, AN)
region: UN region
subregion: UN subregion
population: Population estimate
area: Total area in km²
currency: ISO currency code
currency_name: Currency name
currency_symbol: Currency symbol
tld: Top-level domain
calling_code: International calling code with plus (+1, +44)
emoji: Flag emoji
languages: ISO 639 language codes. Expand each at /language/{code}
borders: Neighboring country ISO2 codes
blocs: Bloc memberships (EU, EEA, SCHENGEN, EUROZONE, SEPA, NATO, and more). Expand each at /bloc/{code}
timezones: IANA timezone ids used in the country. The US lists 29
week_start: First day of the week (monday, sunday, saturday)
units: Measurement system (metric or imperial)
driving_side: left or right
plugs: Power plug types, IEC letters (A through O)
voltage: Residential mains voltage. Null when no single standard exists
frequency: Mains frequency in Hz. Null when the grid is split (Japan runs both 50 and 60)
emergency: Emergency numbers: police, ambulance, fire. Null when not confirmed
postal_format: Postal code mask, # is a digit and A is a letter. Null when the country has no postal codes
postal_regex: Anchored regex matching valid postal codes
tax: National sales tax name (VAT, GST). Null when there is none, like the US
tax_rate: Standard rate as a percent (19, 8.1)
tax_id_format: Tax id example format, 9 is a digit (DE999999999)
tax_id_regex: Anchored regex matching valid tax ids
ioc: Olympic committee code (GER, NED, SUI)
fifa: FIFA code. Null for GB, the home nations are the members
plate: International vehicle plate code (D, UK, CH)

QUESTIONS

When do I use which?: A code or name for the country record. /states for every state or province in it.
ISO2 or ISO3?: Either. /country/us and /country/usa are the same record.
Can I pass a name?: Yes. /country/germany and /country/deutschland resolve. Accents are optional, cote divoire finds Ivory Coast.
What comes back?: Capital, currency, languages, borders, timezones, week start, driving side, plug types with voltage, emergency numbers, postal format, the national tax and its rate, and the IOC, FIFA, and plate codes. 41 fields.
What is the tax field?: The national sales tax by its local name. Germany answers VAT at 19. Japan answers Consumption tax at 10. The US answers null, there is no national sales tax.
What is local_name?: What the country calls itself. Japan is Japan. local_name reads 日本.
How do I list states?: GET /country/{code}/states. Every admin division in that country.

SPEED

How long /country takes.

10ms

APAC

42ms

LatAm

14ms

121ms

See live status →

Coverage

250 countries and territories. Official records.

NANorth America41 countries
EUEurope53 countries
AFAfrica58 countries
ASAsia52 countries
OCOceania27 countries
SASouth America14 countries
ANAntarctica5 countries

Every ISO code in one table: the country codes list.

Get started Docs