JSONKit
Data

Country Codes (ISO 3166-1) JSON Example

A comprehensive JSON reference of ISO 3166-1 country codes including alpha-2, alpha-3, numeric codes, continent, and calling code. Ideal for locale selection, address forms, and analytics pipelines.

{
  "countries": [
    {
      "alpha2": "US",
      "alpha3": "USA",
      "numeric": "840",
      "name": "United States",
      "continent": "Americas",
      "callingCode": "+1"
    },
    {
      "alpha2": "GB",
      "alpha3": "GBR",
      "numeric": "826",
      "name": "United Kingdom",
      "continent": "Europe",
      "callingCode": "+44"
    },
    {
      "alpha2": "DE",
      "alpha3": "DEU",
      "numeric": "276",
      "name": "Germany",
      "continent": "Europe",
      "callingCode": "+49"
    },
    {
      "alpha2": "FR",
      "alpha3": "FRA",
      "numeric": "250",
      "name": "France",
      "continent": "Europe",
      "callingCode": "+33"
    },
    {
      "alpha2": "JP",
      "alpha3": "JPN",
      "numeric": "392",
      "name": "Japan",
      "continent": "Asia",
      "callingCode": "+81"
    },
    {
      "alpha2": "CN",
      "alpha3": "CHN",
      "numeric": "156",
      "name": "China",
      "continent": "Asia",
      "callingCode": "+86"
    },
    {
      "alpha2": "IN",
      "alpha3": "IND",
      "numeric": "356",
      "name": "India",
      "continent": "Asia",
      "callingCode": "+91"
    },
    {
      "alpha2": "BR",
      "alpha3": "BRA",
      "numeric": "076",
      "name": "Brazil",
      "continent": "Americas",
      "callingCode": "+55"
    },
    {
      "alpha2": "AU",
      "alpha3": "AUS",
      "numeric": "036",
      "name": "Australia",
      "continent": "Oceania",
      "callingCode": "+61"
    },
    {
      "alpha2": "CA",
      "alpha3": "CAN",
      "numeric": "124",
      "name": "Canada",
      "continent": "Americas",
      "callingCode": "+1"
    },
    {
      "alpha2": "RU",
      "alpha3": "RUS",
      "numeric": "643",
      "name": "Russia",
      "continent": "Europe",
      "callingCode": "+7"
    },
    {
      "alpha2": "MX",
      "alpha3": "MEX",
      "numeric": "484",
      "name": "Mexico",
      "continent": "Americas",
      "callingCode": "+52"
    },
    {
      "alpha2": "KR",
      "alpha3": "KOR",
      "numeric": "410",
      "name": "South Korea",
      "continent": "Asia",
      "callingCode": "+82"
    },
    {
      "alpha2": "IT",
      "alpha3": "ITA",
      "numeric": "380",
      "name": "Italy",
      "continent": "Europe",
      "callingCode": "+39"
    },
    {
      "alpha2": "ES",
      "alpha3": "ESP",
      "numeric": "724",
      "name": "Spain",
      "continent": "Europe",
      "callingCode": "+34"
    },
    {
      "alpha2": "NG",
      "alpha3": "NGA",
      "numeric": "566",
      "name": "Nigeria",
      "continent": "Africa",
      "callingCode": "+234"
    },
    {
      "alpha2": "ZA",
      "alpha3": "ZAF",
      "numeric": "710",
      "name": "South Africa",
      "continent": "Africa",
      "callingCode": "+27"
    },
    {
      "alpha2": "AR",
      "alpha3": "ARG",
      "numeric": "032",
      "name": "Argentina",
      "continent": "Americas",
      "callingCode": "+54"
    },
    {
      "alpha2": "EG",
      "alpha3": "EGY",
      "numeric": "818",
      "name": "Egypt",
      "continent": "Africa",
      "callingCode": "+20"
    },
    {
      "alpha2": "SA",
      "alpha3": "SAU",
      "numeric": "682",
      "name": "Saudi Arabia",
      "continent": "Asia",
      "callingCode": "+966"
    },
    {
      "alpha2": "AE",
      "alpha3": "ARE",
      "numeric": "784",
      "name": "United Arab Emirates",
      "continent": "Asia",
      "callingCode": "+971"
    },
    {
      "alpha2": "TH",
      "alpha3": "THA",
      "numeric": "764",
      "name": "Thailand",
      "continent": "Asia",
      "callingCode": "+66"
    },
    {
      "alpha2": "ID",
      "alpha3": "IDN",
      "numeric": "360",
      "name": "Indonesia",
      "continent": "Asia",
      "callingCode": "+62"
    },
    {
      "alpha2": "PK",
      "alpha3": "PAK",
      "numeric": "586",
      "name": "Pakistan",
      "continent": "Asia",
      "callingCode": "+92"
    },
    {
      "alpha2": "VN",
      "alpha3": "VNM",
      "numeric": "704",
      "name": "Vietnam",
      "continent": "Asia",
      "callingCode": "+84"
    },
    {
      "alpha2": "TR",
      "alpha3": "TUR",
      "numeric": "792",
      "name": "Turkey",
      "continent": "Asia",
      "callingCode": "+90"
    },
    {
      "alpha2": "PL",
      "alpha3": "POL",
      "numeric": "616",
      "name": "Poland",
      "continent": "Europe",
      "callingCode": "+48"
    },
    {
      "alpha2": "NL",
      "alpha3": "NLD",
      "numeric": "528",
      "name": "Netherlands",
      "continent": "Europe",
      "callingCode": "+31"
    },
    {
      "alpha2": "SE",
      "alpha3": "SWE",
      "numeric": "752",
      "name": "Sweden",
      "continent": "Europe",
      "callingCode": "+46"
    },
    {
      "alpha2": "CH",
      "alpha3": "CHE",
      "numeric": "756",
      "name": "Switzerland",
      "continent": "Europe",
      "callingCode": "+41"
    }
  ]
}

Field Reference

alpha2requiredstringTwo-letter ISO 3166-1 alpha-2 country code (e.g. 'US', 'GB')
alpha3requiredstringThree-letter ISO 3166-1 alpha-3 country code (e.g. 'USA', 'GBR')
numericrequiredstringThree-digit zero-padded ISO 3166-1 numeric code (e.g. '840')
namerequiredstringOfficial English short name of the country
continentrequiredstringContinent the country belongs to: Africa, Americas, Asia, Europe, or Oceania
callingCoderequiredstringITU international calling code prefixed with '+' (e.g. '+1', '+91')

Variants

G7 Countries onlyThe seven major advanced economies: US, UK, Germany, France, Japan, Canada, Italy.
{
  "countries": [
    {
      "alpha2": "US",
      "alpha3": "USA",
      "numeric": "840",
      "name": "United States",
      "continent": "Americas",
      "callingCode": "+1"
    },
    {
      "alpha2": "GB",
      "alpha3": "GBR",
      "numeric": "826",
      "name": "United Kingdom",
      "continent": "Europe",
      "callingCode": "+44"
    },
    {
      "alpha2": "DE",
      "alpha3": "DEU",
      "numeric": "276",
      "name": "Germany",
      "continent": "Europe",
      "callingCode": "+49"
    },
    {
      "alpha2": "FR",
      "alpha3": "FRA",
      "numeric": "250",
      "name": "France",
      "continent": "Europe",
      "callingCode": "+33"
    },
    {
      "alpha2": "JP",
      "alpha3": "JPN",
      "numeric": "392",
      "name": "Japan",
      "continent": "Asia",
      "callingCode": "+81"
    },
    {
      "alpha2": "CA",
      "alpha3": "CAN",
      "numeric": "124",
      "name": "Canada",
      "continent": "Americas",
      "callingCode": "+1"
    },
    {
      "alpha2": "IT",
      "alpha3": "ITA",
      "numeric": "380",
      "name": "Italy",
      "continent": "Europe",
      "callingCode": "+39"
    }
  ]
}
Asia PacificMajor Asia-Pacific countries including South and Southeast Asia.
{
  "countries": [
    {
      "alpha2": "JP",
      "alpha3": "JPN",
      "numeric": "392",
      "name": "Japan",
      "continent": "Asia",
      "callingCode": "+81"
    },
    {
      "alpha2": "CN",
      "alpha3": "CHN",
      "numeric": "156",
      "name": "China",
      "continent": "Asia",
      "callingCode": "+86"
    },
    {
      "alpha2": "IN",
      "alpha3": "IND",
      "numeric": "356",
      "name": "India",
      "continent": "Asia",
      "callingCode": "+91"
    },
    {
      "alpha2": "AU",
      "alpha3": "AUS",
      "numeric": "036",
      "name": "Australia",
      "continent": "Oceania",
      "callingCode": "+61"
    },
    {
      "alpha2": "KR",
      "alpha3": "KOR",
      "numeric": "410",
      "name": "South Korea",
      "continent": "Asia",
      "callingCode": "+82"
    },
    {
      "alpha2": "TH",
      "alpha3": "THA",
      "numeric": "764",
      "name": "Thailand",
      "continent": "Asia",
      "callingCode": "+66"
    },
    {
      "alpha2": "ID",
      "alpha3": "IDN",
      "numeric": "360",
      "name": "Indonesia",
      "continent": "Asia",
      "callingCode": "+62"
    },
    {
      "alpha2": "VN",
      "alpha3": "VNM",
      "numeric": "704",
      "name": "Vietnam",
      "continent": "Asia",
      "callingCode": "+84"
    },
    {
      "alpha2": "PK",
      "alpha3": "PAK",
      "numeric": "586",
      "name": "Pakistan",
      "continent": "Asia",
      "callingCode": "+92"
    }
  ]
}

Common Use Cases

  • →Phone number validation — combine callingCode with a local number validator
  • →Locale selection dropdowns in signup forms and account settings
  • →Shipping address forms with automatic country auto-complete
  • →Analytics dashboards grouping metrics by country or continent
  • →Data normalization when merging datasets that use different code formats
ISO 3166country codesalpha-2alpha-3internationalizationi18nlocale

Validate or format this JSON

One click loads this exact example into the tool — no copy-paste needed. Format it, validate it, explore the tree, or generate TypeScript types instantly.

FormatValidateExplore treeGenerate TypeScriptMinify

Frequently Asked Questions

ISO 3166-1 is an international standard published by the International Organization for Standardization (ISO) that defines codes for the names of countries, dependent territories, and special areas of geographical interest. It has three parts: alpha-2 (two-letter), alpha-3 (three-letter), and numeric (three-digit) codes.

Alpha-2 codes (e.g. 'US', 'GB') are the most commonly used and appear in language tags (en-US), TLDs (.us), and most APIs. Alpha-3 codes (e.g. 'USA', 'GBR') are more explicit and less ambiguous — preferred in government and financial systems where uniqueness is critical. The numeric codes are machine-friendly and language-neutral.

The official list is maintained by ISO and available at iso.org. Open-source npm packages like 'i18n-iso-countries' provide the full set in JSON format. This dataset covers 30 of the most commonly needed countries; for a complete 249-entry list, use the ISO package directly.

Build a reverse index: const byCallingCode = countries.reduce((acc, c) => { (acc[c.callingCode] ??= []).push(c); return acc; }, {}). Note that '+1' maps to both the US and Canada, so the result is always an array. Strip the '+' when matching against raw phone number prefixes.

Related JSON Examples

DataCurrency Codes (ISO 4217)ISO 4217 currency codes with symbols, minor units, and sample countries.DataIANA Timezones ReferenceMajor IANA timezone IDs with UTC offsets, DST offsets, and regional metadata.API DesignUser ProfileStandard user profile JSON with personal info, address, and account metadata.