Loading
Loading
Retrieve comprehensive metadata for a specific country including ISO codes, capital, currency, phone code, nationality, flag emoji, and geographic region.
Returns complete country details 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.
formatoptionalStringdefault: jsonResponse format: 'json' (default) or 'xml'.
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 details about supported status codes and error responses, refer to the HTTP Error Codes.
Only ISO 3166-1 alpha-2 codes country codes are supported.