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.

Names, currency, languages, calling code, flag, and timezones form the ordinary response. Paid deep adds the country profile: statistics, capital, borders, blocs, regional conventions, formats, tax references, and alternate identifiers.

What is the tax field?

Paid deep.tax names the national sales tax, VAT, or GST. deep.tax_rate is a percentage: 19 means 19%. The US has null because there is no national sales tax.

What the country calls itself. Japan is Japan. name_local reads 日本. It is null when absent or identical to name.

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. Names, currency, languages, and timezones.

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

Example response/country/us

{
  "country": "US",
  "name": "United States",
  "name_local": null,
  "continent": "NA",
  "currency": "USD",
  "currency_name": "United States Dollar",
  "currency_symbol": "$",
  "calling_code": "+1",
  "emoji": "🇺🇸",
  
    "en"
  ],
  
    "America/Adak",
    "America/Anchorage",
    "America/Boise",
    "America/Chicago"
  ],
  ?deep=true
}

1M requests · $20/mo. Get started

What comes back.

name

Common name

deep.capital

Capital city

currency

ISO currency code

languages

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

deep.borders

Neighboring country ISO2 codes

timezones

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

deep.week_start

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

deep.units

Measurement system (metric or imperial)

deep.driving_side

left or right

deep.plugs

Power plug types, IEC letters (A through O)

deep.voltage

Residential mains voltage. Null when no single standard exists

deep.emergency

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

deep.postal_format

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

deep.tax

National levy name (VAT, GST). Null when unavailable or no national levy applies, like the US

deep.tax_rate

Standard national reference rate in percent: 19 means 19%. Do not add it to a state or ZIP reference

deep.ioc

Olympic committee code (GER, NED, SUI)

deep.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

Names, currency, languages, and timezones. Add deep=true on a paid plan for the country profile, statistics, and local conventions.

List the states

GET /country/{code}/states.

Coverage

250 countries and territories. Official records.

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

250
countries: 156
currencies: 229
countries with states

Look up a country by ISO2, ISO3, or name. Names, currency, languages, calling code, coordinates, and timezones give you the facts for forms and localization. name is English and name_local is the endonym, or null when absent or identical to name.

Paid deep adds a country profile: statistics, capital, borders and blocs, alternate identifiers, regional conventions, postal formats, and tax references. Need states or regions? Use /country/{code}/states on every plan.

SPEED

How long /country takes.

Median time to first byte over the last seven days. Warm requests, measured every 30 minutes. Live verification and other request variants can take longer.

15ms

19ms

APAC

36ms

LatAm

26ms

91ms

See live status →

Make your first request.

One key works across the APIs. Copy a request in your language and get JSON back.

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

// Example response · 200
{
  "country": "US",
  "name": "United States",
  "name_local": null,
  "continent": "NA",
  "currency": "USD",
  "currency_name": "United States Dollar",
  "currency_symbol": "$",
  "calling_code": "+1",
  "emoji": "🇺🇸",
  "languages": ["en"],
  "timezones": [
    "America/Adak",
    "America/Anchorage",
    "America/Boise",
    "America/Chicago",
    // ... 25 more
  ]
}

API reference SDKs Keys and authentication

Every response field

Response fields

country: ISO2 country code
name: Common name
name_local: Local-language name, null when absent or identical to name
continent: Continent code (NA, EU, AF, AS, OC, SA, AN)
currency: ISO currency code
currency_name: Currency name
currency_symbol: Currency symbol
calling_code: International calling code with plus (+1, +44)
emoji: Flag emoji
languages: ISO 639 language codes. Expand each at /language/{code}
timezones: IANA timezone ids used in the country. The US lists 29

Deep fields

deep.iso3: Three-letter country code
deep.numeric: UN numeric code
deep.full_name: Official long name
deep.demonym: Demonym
deep.capital: Capital city
deep.capital_lat: Capital latitude (null when there is no capital)
deep.capital_lon: Capital longitude (null when there is no capital)
deep.region: UN region
deep.subregion: UN subregion
deep.population: Population estimate
deep.population_period: Observation year or multi-year period for this population estimate (YYYY or YYYY-YYYY). Null when the record has no verified period or population. Never the import date.
deep.area: Total area in km²
deep.land_area: Published land area in km². Null when unavailable or its published total differs from area
deep.water_area: Published water area in km². Null when unavailable or its published total differs from area
deep.coastline: Published coastline length in kilometers. Zero is known zero; null is unavailable
deep.elevation: Mean elevation in meters above sea level. Null when unavailable
deep.lowest_point: Lowest geographic point, or null when unavailable or ambiguous
deep.lowest_point.name: Published place name. Null when unnamed
deep.lowest_point.elevation: Meters above sea level. Negative values are below sea level
deep.highest_point: Highest geographic point, or null when unavailable or ambiguous
deep.highest_point.name: Published place name. Null when unnamed
deep.highest_point.elevation: Meters above sea level
deep.tld: Top-level domain
deep.borders: Neighboring country ISO2 codes
deep.blocs: Bloc memberships (EU, EEA, SCHENGEN, EUROZONE, SEPA, NATO, and more). Expand each at /bloc/{code}
deep.week_start: First day of the week (monday, sunday, saturday)
deep.units: Measurement system (metric or imperial)
deep.driving_side: left or right
deep.plugs: Power plug types, IEC letters (A through O)
deep.voltage: Residential mains voltage. Null when no single standard exists
deep.frequency: Mains frequency in Hz. Null when the grid is split (Japan runs both 50 and 60)
deep.emergency: Emergency numbers: police, ambulance, fire. Null when not confirmed
deep.postal_format: Postal code mask, # is a digit and A is a letter. Null when the country has no postal codes
deep.postal_regex: Anchored regex matching valid postal codes
deep.tax: National levy name (VAT, GST). Null when unavailable or no national levy applies, like the US
deep.tax_rate: Standard national reference rate in percent: 19 means 19%. Do not add it to a state or ZIP reference
deep.tax_id_format: Tax id example format, 9 is a digit (DE999999999)
deep.tax_id_regex: Anchored tax ID format regex. A match does not establish registration
deep.ioc: Olympic committee code (GER, NED, SUI)
deep.fifa: FIFA code. Null for GB, the home nations are the members
deep.plate: International vehicle plate code (D, UK, CH)

Build with Country

All tutorials →

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?: Names, currency, languages, calling code, flag, and timezones form the ordinary response. Paid deep adds the country profile: statistics, capital, borders, blocs, regional conventions, formats, tax references, and alternate identifiers.
What is the tax field?: Paid deep.tax names the national sales tax, VAT, or GST. deep.tax_rate is a percentage: 19 means 19%. The US has null because there is no national sales tax.
What is name_local?: What the country calls itself. Japan is Japan. name_local reads 日本. It is null when absent or identical to name.
How do I list states?: GET /country/{code}/states. Every admin division in that country.

Country, decoded.

Country codes on every plan. Detailed profiles on paid plans.

Start includes 1M API requests a month for $20/mo.

Get started Compare plans Read the docs