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
cisoURLISO2 Code of CountryRequiredstring

Response

CodeDescription
200Return a list of cities
401Unauthorized.
404Not Found.

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."
}
Last updated on by Darshan Gada