Skip to main content

Get country details from ISO2 code

GET https://api.countrystatecity.in/v1/countries/[ciso]

Security#

This api use API KEY as an authentication method.

  • Name: X-CSCAPI-KEY
  • In: header

Request Parameters#

NameLocated inDescriptionRequiredType
[ciso]URLISO2 Code of CountryRequiredstring

Response#

CodeDescription
200Return a details of country
401Unauthorized.
404Not Found.

Example Usage#

countries-states-cities.js
var headers = new Headers();headers.append("X-CSCAPI-KEY", "API_KEY");
var requestOptions = { method: 'GET', headers: headers, redirect: 'follow'};
fetch("https://api.countrystatecity.in/v1/countries/IN", requestOptions).then(response => response.text()).then(result => console.log(result)).catch(error => console.log('error', error));

Example Success Response#

{  "id": 101,  "name": "India",  "iso3": "IND",  "iso2": "IN",  "phonecode": "91",  "capital": "New Delhi",  "currency": "INR",  "native": "भारत",  "emoji": "🇮🇳",  "emojiU": "U+1F1EE U+1F1F3"}

Example Error Response#

{  "error'": "Unauthorized. You shouldn't be here."}

Example Not Found Response#

{  "error'": "Country not found."}