country-code-iso

A JSON dataset of countries with ISO codes, dial codes, timezones, TLDs, and flag assets.

Data

• File: country-codes.json
• Format: JSON array of country objects
• Count: 253 countries/territories

Schema

Each entry has:

Field	Type	Description
name	string	Country or territory name
isoA2	string	ISO 3166-1 alpha-2 (e.g. "MY")
isoA3	string	ISO 3166-1 alpha-3 (e.g. "MYS")
isoNumber	number	ISO 3166-1 numeric (e.g. 458)
tld	string	Top-level domain (e.g. ".my")
emoji	string	Flag emoji (e.g. "🇲🇾")
image	string	SVG flag URL (flag-icons CDN)
dialCodes	string[]	International dial codes (e.g. ["+60"])
timezones	string[]	Timezone(s) (e.g. ["GMT+8"])
continentCode	string	Continent code (e.g. "AS")
continentName	string	Continent name (e.g. "Asia")

Example

{
  "name": "Malaysia",
  "isoA2": "MY",
  "isoA3": "MYS",
  "isoNumber": 458,
  "tld": ".my",
  "emoji": "🇲🇾",
  "image": "https://cdn.jsdelivr.net/gh/lipis/flag-icons@7.2.3/flags/4x3/my.svg",
  "dialCodes": ["+60"],
  "timezones": ["GMT+8"],
  "continentCode": "AS",
  "continentName": "Asia"
}

Usage

Use country-codes.json in apps that need country metadata: forms, selectors, validation, or display. Flag images are served from flag-icons via jsDelivr.

Other references

• Country–continent mapping (John Snow Labs / Datahub)
• Countries list (zspine)
• Countries / country codes (anubhavshrimal)
• List of telephone country codes (Wikipedia)
• List of ISO 3166 country codes (Wikipedia)
• country-codes dataset (CSV)

License

MIT © country-code-iso contributors