What does a flag record include?

The ISO 3166-1 alpha-2, alpha-3 and numeric codes, the country name localized to the requested language, the flag emoji and a self-hosted SVG flag URL.

How are names localized?

At runtime from the Unicode CLDR data built into the platform, so any language tag such as es, de or ja works without a translation table.

Can I hotlink the SVGs?

Yes. Flag SVGs are served from this site's own storage and do not require an API key, so they can be used directly in an img tag.

Which countries are covered?

Every ISO 3166-1 entry, including territories, with a region filter.

What does a call cost?

1 token for the data endpoints. Loading the SVG images themselves is free.

DataMAINTAINED1 token / call

Country Flags API

ISO 3166 codes, localized country names, flag emoji and SVG flag URLs for every country

Flags and identity data for every country: ISO 3166-1 codes (alpha-2, alpha-3, numeric), localized country name, the flag emoji, and an SVG flag image URL. Filter by region and localize names with a single query param.

Every call needs an X-Api-Key header. A free key includes 500 tokens a month, no card required. 1 token per call, so the free plan covers about 500 calls a month.

Start free — 500 tokens / mo →See all plans

No credit card requiredAccess to 125+ APIsCancel anytime

response.json

{
  "name": "United States",
  "code": "US",
  "alpha3": "USA",
  "numeric": "840",
  "region": "Americas",
  "emoji": "🇺🇸",
  "flag_svg": "https://dataandapis.com/flags/us.svg"
}

Production Ready: Battle-tested infrastructure with a 99.9% uptime SLA. Rate limits are generous, responses are consistent.
Simple Integration: Standard REST + JSON. Works with any HTTP client. Copy-ready code snippets in 4 languages.
One Key, 125+ APIs: Your DataAndAPIs subscription unlocks every API on the platform — anime, finance, sports, and more.

Use cases for Country Flags API

Show the right flag next to a country, phone prefix or language selector.
Convert between alpha-2, alpha-3 and numeric ISO codes in data pipelines.
Display country names in the user's language with one query parameter.
Filter countries by region for forms and reports.

Country Flags API endpoints

Every endpoint with its parameters and a real example response.

GETGet Flag By Code
GETList Flags

GETGet Flag By Code

https://api-country-flags.dataandapis.com/v1/flags/{code}

Path parameters

Parameter	Example
code	US	Required

Query parameters

Parameter	Example
lang	fr	Optional

Example request

curl "https://api-country-flags.dataandapis.com/v1/flags/US?lang=fr" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "name": "United States",
  "code": "US",
  "alpha3": "USA",
  "numeric": "840",
  "region": "Americas",
  "emoji": "🇺🇸",
  "flag_svg": "https://dataandapis.com/flags/us.svg"
}

GETList Flags

https://api-country-flags.dataandapis.com/v1/flags

Query parameters

Parameter	Example
lang	en	Optional
region	Europe	Optional

Example request

curl "https://api-country-flags.dataandapis.com/v1/flags?lang=en&region=Europe" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "count": 250,
  "countries": [
    {
      "name": "United States",
      "code": "US",
      "alpha3": "USA",
      "numeric": "840",
      "region": "Americas",
      "emoji": "🇺🇸",
      "flag_svg": "https://dataandapis.com/flags/us.svg"
    },
    {
      "name": "United Kingdom",
      "code": "GB",
      "alpha3": "GBR",
      "numeric": "826",
      "region": "Europe",
      "emoji": "🇬🇧",
      "flag_svg": "https://dataandapis.com/flags/gb.svg"
    }
  ]
}

Where the data comes from

Source: ISO 3166-1 reference table, Unicode CLDR names and self-hosted flag SVGs.
Freshness: Static reference data; updated with ISO changes.

One install. Every endpoint.

No proprietary SDKs needed. Any HTTP client works. Pick your language and paste.

3languages

2endpoints

RESTarchitecture

1key for all APIs

Fully typed responses — auto-completion in your IDE
Tracks the API in lockstep — new endpoints land same day
One key works across 125+ APIs on the platform

import axios from 'axios';

const { data } = await axios.get(
  'https://api-country-flags.dataandapis.com/v1/flags/{code}',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Country Flags API · X-Api-Key

Explore the endpoints

Browse request parameters and inspect live example responses.

Available Endpoints

Request Parameters

API URL

Headers

X-Api-Key

Query Parameters

lang(Optional)

Path Parameters

code

Target:

Client:

import axios from 'axios';

const url = 'https://api-country-flags.dataandapis.com/v1/flags/{code}';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});