Skip to main content

Get a list of States

GET https://api.countrystatecity.in/v1/states

Security#

This api use API KEY as an authentication method.

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

Request Parameters#

No parameters

Response#

CodeDescription
200Return a list of states
401Unauthorized.

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

Example Success Response#

[  {    "id": 4008,    "name": "Maharashtra",    "country_id": 101,    "country_code": "IN",    "iso2": "MH"  },  ...]

Example Error Response#

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