The layer most country datasets skip.
States, provinces and other administrative divisions linked to their parent country. Subdivision codes, division types and other fields depend on the record and your plan.
Coverage varies by release. Check the API statistics and database releases for current data. Read the ODbL-1.0 licence before using the database.
curl --location 'https://api.countrystatecity.in/v1/countries/IN/states/MH' \ --header 'X-CSCAPI-KEY: YOUR_API_KEY'Community response excerpt
{
"id": 4008,
"name": "Maharashtra",
"iso2": "MH",
"country_id": 101,
"country_code": "IN"
}Endpoints
These endpoints are served from https://api.countrystatecity.in/v1 and require your key in the X-CSCAPI-KEY header. Availability depends on your plan.
Available fields for state records.
Fields depend on your plan and may be missing or null. On eligible plans, select fields with ?fields=. Compare plan access.
idStable numeric identifiernameEnglish nameiso2Subdivision part of the ISO codeiso3166_2Full ISO 3166-2 codecountry_idParent country idcountry_codeParent country ISO2typestate, province, region, canton and so onlevelDepth in the official hierarchyparent_idParent division, where one existsfips_codeFIPS 10-4 codenativeName in the local scriptlatitudeCentroid latitudelongitudeCentroid longitudetimezoneIANA zonepopulationWhen available; may be nulltranslationsName in other languageswikiDataIdWikidata itemWhat people build with it.
- The second dropdown in a country, state and city address form, filtered by the country already chosen.
- Tax and shipping rules that differ by state, keyed on ISO 3166-2 rather than on a free-text name.
- Sales territories and reporting regions built on official divisions instead of an internal spreadsheet.
- Normalising inbound addresses where one system writes "Maharashtra" and another writes "MH".
Questions.
Which countries have state data?
Coverage varies by country and territory. Records can represent different administrative levels. Use /countries/{ciso}/states to inspect the current entries for a country; some places may have no listed divisions.
Do you return ISO 3166-2 codes?
The iso3166_2 field contains a subdivision code when available, alongside iso2. Some records lack a code, and field access depends on your plan.
What does the type field contain?
A division classification such as state, province, region or prefecture, when available. Values and administrative levels vary by record and country; access to this field depends on your plan.
Can I fetch every state in one request?
GET /states lists states on Starter and higher plans. Community includes /countries/{ciso}/states for a country-by-country load. Check the current plan comparison for endpoint availability.
Free up to 3,000 requests a month.
Paid plans from $5 add higher limits. Supporter adds fuzzy search; Professional adds GraphQL and the change feed.