Loading
Loading
Get detailed information about a specific country — ISO codes, capital, currency, languages, calling code, area, and population.
The Country Details API returns comprehensive information for a single country identified by its ISO 3166-1 alpha-2 code.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
The following parameter is required to identify the country.
countryrequiredStringCountry code in ISO 3166-1 alpha-2 format.
A successful request returns a 200 OK response with a JSON object containing the country details.
nameThe full English name of the country (e.g., "Pakistan").
iso_alpha_2The ISO 3166-1 alpha-2 two-letter country code (e.g., "PK").
iso_alpha_3The ISO 3166-1 alpha-3 three-letter country code (e.g., "PAK").
iso_numericThe ISO 3166-1 numeric country code (e.g., 586).
phone_codeThe international dialing/phone code for the country (e.g., 92).
capitalThe capital city of the country (e.g., "Islamabad").
top_level_domainThe country-code top-level internet domain (e.g., ".pk").
native_nameThe name of the country in its native language (e.g., "پاکستان").
regionThe broad geographical region the country belongs to (e.g., "Asia").
subregionThe more specific subregion the country belongs to (e.g., "Southern Asia").
nationalityThe demonym for citizens of the country (e.g., "Pakistani").
flag_emojiThe emoji flag representing the country (e.g., "🇵🇰").
currency_codeThe ISO 4217 currency code used in the country (e.g., "PKR").
currency_nameThe full name of the currency used in the country (e.g., "Pakistani rupee").
currency_symbolThe symbol of the currency used in the country (e.g., "₨").
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
Only ISO 3166-1 alpha-2 codes country codes are supported.