apyhub
Back
β–£ VERIFICATION KIT

Country Information API

Hosted on ApyHub

What it does

Country Information API looks up one country from its two-letter code and returns a JSON data object with the country name, ISO 3166-1 alpha-3 code, flag emoji, currency details, and calling codes.

Send the country query parameter with a two-letter ISO 3166-1 alpha-2 code such as DE or IN. The response includes key, cca3, emoji, value, and a nested currency object with key, emoji, value, and symbol. It can also return calling_codes, plus subdivision items with code and name when they are available.

Teams use this Country Information API for country code lookup, currency lookup, and calling code lookup in checkout forms and admin tools. It also helps fill region dropdowns after country selection, power onboarding flows, and turn stored ISO country data into readable labels.

If you need the full country list first, use the Countries Dictionary API. For currency workflows, pair it with the Currencies Dictionary API or the Currency Converter API.

GET
Detailed info for a single country
https://api.eu.apyhub.com/apyhub/detailed-info-for-a-single-country

QUICKSTART

GUIDE

Quickstart

Fetch detailed information for a single country by passing its ISO 3166-1 alpha-2 code as a query parameter.

curl -X GET "https://api.eu.apyhub.com/apyhub/detailed-info-for-a-single-country?country=DE" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with a data object field containing country details. The data object may include fields like key, cca3, emoji, value, currency, subdivision, and calling_code.

{
  "data": {
    "key": "DE",
    "cca3": "DEU",
    "emoji": "πŸ‡©πŸ‡ͺ",
    "value": "Germany"
  }
}
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 detailed information for a single country identified by its country code passed in the country query parameter. The response is a JSON object containing a data object with country details and, when present in the schema, subdivision and calling code arrays.

Query Parameter(s)

AttributeTypeDescription
countryStringCountry code to look up.

Response

Returns a JSON object with a data object field. The data object includes country metadata such as key, cca3, emoji, value, and currency, and may also include subdivision and calling_code arrays.

AttributeTypeDescription
dataObjectCountry details object. Includes key as the ISO 3166-1 alpha-2 code, cca3 as the ISO 3166-1 alpha-3 code, emoji, value as the country name, currency as a nested object, and calling_codes as a string array. It may also include subdivision as an object array and calling_code as a string array.
data.keyStringISO 3166-1 alpha-2 code.
data.cca3StringISO 3166-1 alpha-3 code.
data.emojiStringCountry emoji.
data.valueStringCountry name.
data.currencyObjectCurrency details object with key, emoji, value, and symbol.
data.currency.keyStringISO 4217 currency code.
data.currency.emojiStringCurrency emoji.
data.currency.valueStringCurrency name in English.
data.currency.symbolStringCurrency symbol.
data.calling_codesString ArrayCalling codes associated with the country.
data.subdivisionObject ArrayCountry subdivisions. Each item contains subdivision code and name.
data.subdivision[].codeStringISO 3166-2 subdivision code.
data.subdivision[].nameStringSubdivision name.
β–£ 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.