Method: GET
Content Type: application/json
Query Parameter(s)
Attribute | Type | Mandatory | Description |
---|
country | String | Yes | The name of the country for which you want to find the details (country name or country code). |
Response
Attribute | Type | Description |
---|
data.key | String | The unique country code (For example, "US" for United States ). |
data.value | String | The full name of the country (For example, "United States"). |
data.cca3 | String | The unique three-digit country code (For example,"USA" for the United States). |
data.emoji | String | The emoji flag for the country(For example, πΊπΈ for United States). |
data.calling_code | Array of Integers | Array of international calling codes used to dial to the country (For example,[1] for the United States). |
data.subdivision | Array | Array of administrative divisions within the country (For example, states or regions ). |
data.subdivision[a].code | String | The code for the specific subdivision (For example, "US-CA" for California in United States). |
data.subdivision[a].name | String | The name of the specific subdivision (For example, "Californoia" for a subdivision in the United States). |
data.currency.key | String | The ISO currency code (For example,"USD" for United States Dollar). |
data.currency.value | String | The name of the currency used in the country (For example, "US Dollar"). |
data.currency.symbol | String | The symbol of the currency (For example, "$"). |
data.currency.emoji | String | The currency emoji for that currency (For example, π΅ ). |
Sample Response
A successful request returns country informaiton in JSON format. If the request fails, the response contains an error code and a message to help determine what went wrong.
HTTP Response Codes
The method may return one of the following HTTP status codes:
Status Code | Description |
---|
200 | The request was successful. |
400 | Invalid input - the country is not provided. |
401 | Required authentication information is either missing or not valid for the resource. |
500 | If any unexpected error occurs while processing the request. |