Country API

A country by ISO2 or ISO3, capital, currency, states.

Look up a country by ISO2 or ISO3. us and usa are the same. Response country is always ISO2. Capital, currency, languages, borders, and the rest.

Lookup

GET

api.parseapi.com/country/{code}

By ISO2 or ISO3. Capital, currency, languages, borders

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

{
  "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.",
  "continent": "NA",
  "region": "Americas",
  "subregion": "Northern America",
  "population": 331002651,
  "area": 9833520,
  "currency": "USD",
  "currency_name": "United States Dollar",
  "currency_symbol": "$",
  "tld": ".us",
  "emoji": "🇺🇸",
  "languages": [
    "en"
  ],
  "borders": [
    "CA",
    "MX"
  ]
}

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
continent: Continent code (NA, EU, AF, AS, OC, SA, AN)
region: UN region
subregion: UN subregion
population: Population estimate
area: Land area in km²
currency: ISO currency code
currency_name: Currency name
currency_symbol: Currency symbol
tld: Top-level domain
emoji: Flag emoji
languages: ISO 639 language codes. Expand each at /language/{code}
borders: Neighboring country ISO2 codes

States in a country

Every state or region in that country. Built for address forms and shipping rules.

GET

api.parseapi.com/country/{code}/states

States and regions in a country

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

{
  "country": "US",
  "states": [
    {
      "state": "AL",
      "name": "Alabama",
      "type": "state"
    },
    {
      "state": "AK",
      "name": "Alaska",
      "type": "state"
    },
    {
      "state": "NC",
      "name": "North Carolina",
      "type": "state"
    },
    // ... 57 more
  ]
}

Response fields

country: ISO2 country code
states[].state: State or province code
states[].name: State or province name
states[].type: State, province, etc.

Questions? Email