Country Flag Emoji JSON

Country flag emojis in JSON format and SVG image.

CDN

Check out the /dist directory to see all available JSON files and SVG images. All These files are also available through JSDELIVR CDN.

List of Country Flag Emojis

You can use the following URL to get a list of all country flag emojis:

cdn.jsdelivr.net/npm/[email protected]/dist/index.json

[
  {
    "name": "Ascension Island",
    "code": "AC",
    "emoji": "🇦🇨",
    "unicode": "U+1F1E6 U+1F1E8",
    "image": "https://cdn.jsdelivr.net/npm/[email protected]/dist/images/AC.svg"
  },
  // More items...
  {
    "name": "Indonesia",
    "code": "ID",
    "emoji": "🇮🇩",
    "unicode": "U+1F1EE U+1F1E9",
    "image": "https://cdn.jsdelivr.net/npm/[email protected]/dist/images/ID.svg"
  },
  // More items...
]

name: The country name
code: The country code based on ISO 3166-1 alpha-2
emoji: The country flag emoji
unicode: The unicode code points for presenting the emoji flag
image: The country flag SVG image url

List of Country Flag Emojis by Country Code

If you prefer the list to be keyed by the country code, use the following URL:

cdn.jsdelivr.net/npm/[email protected]/dist/by-code.json

{
  "AC": {
    "name": "Ascension Island", 
    "emoji": "🇦🇨", 
    "unicode": "U+1F1E6 U+1F1E8", 
    "image": "https://cdn.jsdelivr.net/npm/[email protected]/dist/images/AC.svg"
  },
  // More items...
  "ID": {
    "name": "Indonesia",
    "emoji": "🇮🇩",
    "unicode": "U+1F1EE U+1F1E9",
    "image": "https://cdn.jsdelivr.net/npm/[email protected]/dist/images/ID.svg"
  },
  // More items...
}

Country Code for Subdivision Flags

As of 2021, there are three subdivision flags included: England, Scotland, and Wales. These countries are not listed on ISO 3166-1 alpha-2, thus three of them listed with a non-standard code field:

[
  // More items...
  {
    "name": "England",
    "code": "ENGLAND",
    "emoji": "🏴󠁧󠁢󠁥󠁮󠁧󠁿",
    "unicode": "U+1F3F4 U+E0067 U+E0062 U+E0065 U+E006E U+E0067 U+E007F",
    "image": "https://cdn.jsdelivr.net/npm/[email protected]/dist/images/ENGLAND.svg"
  },
  {
    "name": "Scotland",
    "code": "SCOTLAND",
    "emoji": "🏴󠁧󠁢󠁳󠁣󠁴󠁿",
    "unicode": "U+1F3F4 U+E0067 U+E0062 U+E0073 U+E0063 U+E0074 U+E007F",
    "image": "https://cdn.jsdelivr.net/npm/[email protected]/dist/images/SCOTLAND.svg"
  },
  {
    "name": "Wales",
    "code": "WALES",
    "emoji": "🏴󠁧󠁢󠁷󠁬󠁳󠁿",
    "unicode": "U+1F3F4 U+E0067 U+E0062 U+E0077 U+E006C U+E0073 U+E007F",
    "image": "https://cdn.jsdelivr.net/npm/[email protected]/dist/images/WALES.svg"
  }
]

Generate the JSON

If you want to generate the JSON files by yourself:

1. Clone the Repository

Clone this repository to your local computer:

$ git clone [email protected]:risan/country-flag-emoji-json.git

2. Install the Dependencies

CD into the project directory and install the dependencies:

# Go to the project directory
$ cd country-flag-emoji-json

# Install the dependencies
$ npm install

3. Generate the JSON Files

Run the following command to generate the JSON files:

$ npm run build

country-flag-emoji: List of country codes and its flag emojis.

Data Source

Emojis data used to generate the JSON files are provided by the Unicode Consortium.
All country flag SVG images are designed by OpenMoji – the open-source emoji and icon project. License: CC BY-SA 4.0

License

CC-BY-SA 4.0 · Risan Bagja Pradana

risan/country-flag-emoji-json

risan

Reviews

Repository Details