Get a list of States within country

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

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 states
401Unauthorized.
404Not Found.

Example Success Response

[
{
"id": 4008,
"name": "Maharashtra",
"iso2": "MH"
},
...
]

Example Error Response

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

Example Not Found Response

{
"error'": "No States/Regions found."
}
Last updated on by Darshan Gada