Get a list of all Cities By Country

GET http://api.countrystatecity.org/v1/countries/{cisoORid}/cities

Authentication#

This free api uses API Key to authenticate. API Key needs to be passed in headers.

Header Name : X-API-KEY

Request Parameters#

Name	Location	Description	Required	Type
{cisoORid}	URL	ISO2 Code OR ID	YES	string

Response#

Code	Description
200	Returns a list of cities
401	Unauthorized
404	Not Found

Example Usage#

script.js

var headers = new Headers();
headers.append("X-API-KEY", "api key value");

var requestOptions = {
  method: 'GET',
  headers: headers,
  redirect: 'follow'
};

fetch("https://api.countrystatecity.org/v1/countries/IN/cities", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

Example Success Response#

Success Response

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

Example Error Response#

Error Response

{
  "error":"Unauthorized. Please provide X-API-KEY and api key value in header."
}

Example NotFound Response#

Error Response

{
  "error":"No cities found."
}