apyhub
▣ GEOLOCATION · STANDARD DATA

Countries Dictionary API

Hosted on ApyHub

What it does

Country Directory returns a list of countries with ISO codes and common dialing and currency details in one response. Send a GET request and get structured reference data back for UI selects, form validation, localization logic, and region-aware workflows.

Each country entry includes a two-letter key, a three-letter cca3 code, an emoji, and the country value name. Where available, it also includes a currency object with key, emoji, value, and symbol, plus an array of calling_codes. That makes it straightforward to populate dropdowns, map user input to standard country codes, or drive country-specific defaults in checkout and account setup flows.

Use Country Directory when you need a reliable country reference list without maintaining your own dataset. It is a good fit for registration forms, shipping setup, phone-number routing, and any feature that needs country metadata normalized to ISO standards.

The response is simple and predictable: a top-level data array of country objects. That keeps it easy to cache, filter, and render on the client or server.

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:<br>- key — ISO 3166-1 alpha-2 code.<br>- cca3 — ISO 3166-1 alpha-3 code.<br>- emoji — country flag emoji.<br>- value — country name.<br>- currency — object with currency details, if present:<br>  - currency.key — ISO 4217 currency code.<br>  - currency.emoji — currency emoji.<br>  - currency.value — currency name in English.<br>  - currency.symbol — currency symbol.<br>- calling_codes — array of calling code strings.

Parameters

No parameters.
▣ 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.