About this endpoint
What it does
Retrieves detailed information for a single country based on the country query parameter. The response returns a JSON object containing a data object with country metadata, currency details, calling codes, and subdivisions as defined by the schema.
Query Parameter(s)
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| country | String | Yes | Country identifier to look up. |
Response
Returns a JSON object with a data object field. The data object contains country information such as ISO codes, emoji, country name, currency details, calling codes, and subdivisions, as declared in the schema.
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| data | Object | Yes | Country details object. Includes key (ISO 3166-1 alpha-2 code), cca3 (ISO 3166-1 alpha-3 code), emoji, value (country name), currency (object with key, emoji, value, symbol), calling_codes (String Array), subdivision (Object Array), and calling_code (String Array). |
| data.key | String | No | ISO 3166-1 alpha-2 code. |
| data.cca3 | String | No | ISO 3166-1 alpha-3 code. |
| data.emoji | String | No | Country emoji. |
| data.value | String | No | Country name. |
| data.currency | Object | No | Currency object with key (ISO 4217 currency code), emoji, value (currency name in English), and symbol. |
| data.currency.key | String | No | ISO 4217 currency code. |
| data.currency.emoji | String | No | Currency emoji. |
| data.currency.value | String | No | Currency name in English. |
| data.currency.symbol | String | No | Currency symbol. |
| data.calling_codes | String Array | No | Calling codes associated with the country. |
| data.subdivision | Object Array | No | Administrative subdivisions. Each item contains code (ISO 3166-2 subdivision code) and name. |
| data.subdivision[].code | String | No | ISO 3166-2 subdivision code. |
| data.subdivision[].name | String | No | Subdivision name. |
| data.calling_code | String Array | No | Calling codes associated with the country. |