---
title: Countries Dictionary API
slug: list-all-countries
url: https://apyhub.com/apyhub/service/list-all-countries
provider: ApyHub
categories: [Geolocation, Standard Data]
tags: [countries, iso-3166, country-codes, dialing-codes, currency-reference, reference-data]
auth: api_key
version: 1.0
service_type: sync
endpoints: 1
atoms: 5
mcp: true
alias: data-lists-country
---

# Countries Dictionary API

Get a structured list of countries with ISO codes, currency details, emoji flags, and calling codes for forms, routing, and localization.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/data/dictionary/country` | What it does Returns a JSON object containing a data array of country records. Response Returns a J… | 5 |

## Endpoint reference

### List all countries

`GET https://api.eu.apyhub.com/data/dictionary/country` · 5 atoms · accepts `application/json` · returns `application/json`

#### Quickstart

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

```bash
curl -X GET "https://api.eu.apyhub.com/data/dictionary/country" \
  -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`.

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

## About

## 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.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/apyhub/service/list-all-countries