Skip to main content

Get a list of Cities within country

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

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 list of cities
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/cities", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));

Example Success Response

[
{
"id": 133024,
"name": "Mumbai",
},
...
]

Example Error Response

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

Example Not Found Response

{
"error'": "No Cities found."
}