---
title: Countries Dictionary API
slug: list-countries
url: https://apyverse.com/apyhub/service/list-countries
provider: ApyHub
tags: [countries, reference-data, iso-3166, currency-codes, calling-codes]
auth: api_key
---

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

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| GET | `data/dictionary/country` | What it does Returns a list of countries as a JSON object containing a data array. Each array item… | 5 |

## About

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

## Usage

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