Country API

Response fields

countrystring

ISO2 country code

namestring or null

Common name

name_localstring or null

Local-language name, null when absent or identical to name

continentstring or null

Continent code (NA, EU, AF, AS, OC, SA, AN)

currencystring or null

ISO currency code

currency_namestring or null

Currency name

currency_symbolstring or null

Currency symbol

calling_codestring or null

International calling code with plus (+1, +44)

emojistring or null

Flag emoji

languagesarray or null

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

timezonesarray or null

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

Response fields

countrystring

ISO2 country code

statesarray

Every state or province in the country

states[].statestring or null

State or province code

states[].namestring or null

State or province name

states[].typestring or null

State, province, etc.

Deep fields

deep.iso3string or null

Three-letter country code

deep.numericinteger or null

UN numeric code

deep.full_namestring or null

Official long name

deep.demonymstring or null

Demonym

deep.capitalstring or null

Capital city

deep.capital_latnumber or null

Capital latitude (null when there is no capital)

deep.capital_lonnumber or null

Capital longitude (null when there is no capital)

deep.regionstring or null

UN region

deep.subregionstring or null

UN subregion

deep.populationinteger or null

Population estimate

deep.population_periodstring or null

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.areanumber or null

Total area in km²

deep.land_areanumber or null

Published land area in km². Null when unavailable or its published total differs from area

deep.water_areanumber or null

Published water area in km². Null when unavailable or its published total differs from area

deep.coastlinenumber or null

Published coastline length in kilometers. Zero is known zero; null is unavailable

deep.elevationnumber or null

Mean elevation in meters above sea level. Null when unavailable

deep.lowest_pointobject or null

Lowest geographic point, or null when unavailable or ambiguous

deep.lowest_point.namestring or null

Published place name. Null when unnamed

deep.lowest_point.elevationnumber

Meters above sea level. Negative values are below sea level

deep.highest_pointobject or null

Highest geographic point, or null when unavailable or ambiguous

deep.highest_point.namestring or null

Published place name. Null when unnamed

deep.highest_point.elevationnumber

Meters above sea level

deep.tldstring or null

Top-level domain

deep.bordersarray or null

Neighboring country ISO2 codes

deep.blocsarray

Bloc memberships (EU, EEA, SCHENGEN, EUROZONE, SEPA, NATO, and more). Expand each at /bloc/{code}

deep.week_startstring or null

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

deep.unitsstring or null

Measurement system (metric or imperial)

deep.driving_sidestring or null

left or right

deep.plugsarray or null

Power plug types, IEC letters (A through O)

deep.voltagenumber or null

Residential mains voltage. Null when no single standard exists

deep.frequencynumber or null

Mains frequency in Hz. Null when the grid is split (Japan runs both 50 and 60)

deep.emergencyobject or null

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

deep.postal_formatstring or null

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

deep.postal_regexstring or null

Anchored regex matching valid postal codes

deep.taxstring or null

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

deep.tax_ratenumber or null

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

deep.tax_id_formatstring or null

Tax id example format, 9 is a digit (DE999999999)

deep.tax_id_regexstring or null

Anchored tax ID format regex. A match does not establish registration

deep.iocstring or null

Olympic committee code (GER, NED, SUI)

deep.fifastring or null

FIFA code. Null for GB, the home nations are the members

deep.platestring or null

International vehicle plate code (D, UK, CH)