Countries Endpoint

Returns a list of all countries known to currencyapi, including their associated currencies.

GET/v3/countries

Supported Countries

The endpoint returns country metadata keyed by the two-letter (ISO 3166-1 alpha-2) country code. This endpoint has no parameters of its own — any currencies, type or as_html query values you send are validated (invalid values return a 422) but otherwise ignored.

Response Structure

Our /countries endpoint offers the following information for every country, keyed by its two-letter country code inside the data object:

Name
alpha2
Type
string
Description
The two-letter (ISO 3166-1 alpha-2) country code
Name
alpha3
Type
string
Description
The three-letter (ISO 3166-1 alpha-3) country code
Name
calling_codes
Type
array
Description
The international calling codes of the country (e.g. +971)
Name
currencies
Type
array
Description
The currency codes used in the country — most match the codes of the /currencies endpoint, but a few countries also list ISO 4217 funds/secondary codes (e.g. CHE, CHW, BOV) that are not available as rate currencies
Name
emoji
Type
string
Description
The flag emoji of the country
Name
ioc
Type
string
Description
The International Olympic Committee code of the country
Name
languages
Type
array
Description
The languages spoken in the country, each with a name and name_native
Name
name
Type
string
Description
The English name of the country
Name
name_translated
Type
string
Description
The translated name of the country
Name
timezones
Type
array
Description
The timezones of the country (e.g. Asia/Dubai)
Name
is_in_european_union
Type
boolean
Description
Whether the country is a member of the European Union
Name
tld
Type
string
Description
The top-level domain of the country (e.g. .ae)

Request

GET

/v3/countries

curl -G https://api.currencyapi.com/v3/countries \
    -H "apikey: YOUR-API-KEY"

Full Response

{
    "data": {
        "AE": {
            "alpha2": "AE",
            "alpha3": "ARE",
            "calling_codes": [
                "+971"
            ],
            "currencies": [
                "AED"
            ],
            "emoji": "🇦🇪",
            "ioc": "UAE",
            "languages": [
                {
                    "name": "Arabic",
                    "name_native": "العربية"
                }
            ],
            "name": "United Arab Emirates",
            "name_translated": "United Arab Emirates",
            "timezones": [
                "Asia/Dubai"
            ],
            "is_in_european_union": false,
            "tld": ".ae"
        },
        "...": {}
    }
}