apyhub
Back
▣ GEOLOCATION · STANDARD DATA

Countries Dictionary API

Hosted on ApyHub

What it does

The Country List API returns every country in one request, ready to use in your app. Each country comes with its name, two-letter and three-letter ISO codes, flag emoji, currency (code, name, and symbol), and international calling codes.

Use it to build country dropdowns in sign-up and checkout forms, add country codes to phone number inputs, set the right currency by country, or map user input to standard ISO codes. The list changes rarely, so you can fetch it once and cache it in your app.

Need more detail about a single country? Use the Country Information API. For a full list of currencies, use the Currencies Dictionary API.

You can start on ApyHub's free tier with no card required.

GET
List all countries
https://api.eu.apyhub.com/apyhub/list-all-countries

QUICKSTART

GUIDE

Quickstart

Fetch the full list of countries with a simple GET request.

curl -X GET "https://api.eu.apyhub.com/apyhub/list-all-countries" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with a data array. Each item in data is an object describing a country, including fields like key, cca3, emoji, value, currency, and calling_codes.

{
  "data": [
    {
      "key": "DE",
      "cca3": "DEU",
      "emoji": "🇩🇪",
      "value": "Germany",
      "currency": {
        "key": "EUR",
        "emoji": "💶",
        "value": "Euro",
        "symbol": "€"
      },
      "calling_codes": ["+49"]
    }
  ]
}
TRY ITLIVE · 5 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns a JSON object containing a data array of country records.

Response

Returns a JSON object with a single top-level data array field. Each item in data is an object describing one country, including its ISO codes, emoji, country name, optional currency object, and calling codes.

ParameterTypeMandatoryDescription
dataObject ArrayYesArray of country objects. Each item includes:
- key — ISO 3166-1 alpha-2 code.
- cca3 — ISO 3166-1 alpha-3 code.
- emoji — country flag emoji.
- value — country name.
- currency — object with currency details, if present:
  - currency.key — ISO 4217 currency code.
  - currency.emoji — currency emoji.
  - currency.value — currency name in English.
  - currency.symbol — currency symbol.
- calling_codes — array of calling code strings.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLCurrencies Dictionary APIApyHubCALLCountry Information APIApyHubCALLLanguage Dictionary APIApyHubCALLGet Language Breakdown Used on WebDosvak LLC

From the blog

Reads that touch this API.

What Are the Most Common APIs Used by Front-End Developers?Aug 7, 2026Ultimate Guide to Country Codes: What They Are and How to Use ThemJul 9, 2026Two-Letter Abbreviations for Countries (ISO 3166-1 Alpha-2 Codes) ExplainedSep 10, 2026Timezones Dictionary API: Global Timezone Data and Best Alternatives for 2026Jul 9, 2026