Countries Dictionary API

Countries Dictionary API

What it does

Country Directory returns a structured list of countries with ISO codes, flags, names, currencies, and calling codes. Send a GET request and get back a data array of country objects.

Use the key field for ISO 3166-1 alpha-2 lookups, cca3 for ISO 3166-1 alpha-3 codes, and value for the country name. Each country entry can also include an emoji flag, a currency object with key, value, symbol, and emoji, plus calling_codes for telephone prefix handling.

This is useful when you need a canonical country list for forms, dropdowns, checkout flows, shipping rules, account setup, or data normalization. Instead of hardcoding reference data, you can pull the same country dataset into your app and keep your UI and validation logic aligned.

If you are building international signup flows, locale-aware settings, or region-based product logic, Country Directory gives you the reference fields you need in one response.

{ "data": [ { "key": "DE", "cca3": "DEU", "emoji": "🇩🇪", "value": "Germany", "currency": { "key": "EUR", "emoji": "💶", "value": "Euro", "symbol": "€" }, "calling_codes": ["+49"] } ] }

About this endpoint

What it does

Returns a list of countries as a JSON object containing a data array. Each array item is a country object with country codes, emoji, name, optional currency details, and calling codes as declared in the response schema.

Response

Returns a JSON object with a data array field. Each item in data is an object describing a country. The schema does not declare a specific success status code.

Parameter	Type	Mandatory	Description
data	Object Array	Yes	List of country objects. Each item includes `key`, `cca3`, `emoji`, `value`, optional `currency`, and `calling_codes`.
data[].key	String	No	ISO 3166-1 alpha-2 country code.
data[].cca3	String	No	ISO 3166-1 alpha-3 country code.
data[].emoji	String	No	Country flag emoji.
data[].value	String	No	Country name.
data[].currency	Object	No	Currency information for the country.
data[].currency.key	String	No	ISO 4217 currency code.
data[].currency.emoji	String	No	Currency emoji.
data[].currency.value	String	No	Currency name in English.
data[].currency.symbol	String	No	Currency symbol.
data[].calling_codes	String Array	No	Country calling codes.

Countries Dictionary API

What it does

QUICKSTART

Quickstart

What you'll get back

About this endpoint

What it does

Response

Parameters

Errors any endpoint can return