---
title: "The 36 Indian states + union territories with admin metadata"
method: GET
path: "/v1/states/in"
tags: ["data"]
---

# The 36 Indian states + union territories with admin metadata

`GET /v1/states/in`

## Request

- Base URL: `https://api.travelminds.ai`
- URL: `https://api.travelminds.ai/v1/states/in`
- Auth: none declared

Returns ISO-3166-2 state_code, state_name, capital, type (state | union_territory), region (cardinal), population, area_km2, and Wikidata QID. Optional region/type filters.

## Query parameters

- `region` string, nullable
- `type` string, nullable

## Headers

- `authorization` string, nullable
- `x-rapidapi-proxy-secret` string, nullable
- `x-rapidapi-user` string, nullable
- `x-tmai-proxy-secret` string, nullable
- `x-tmai-proxy-provider` string, nullable
- `x-tmai-proxy-user` string, nullable

## Response `200`

Successful Response

- StateOut[]
  - `state_code` string, required: ISO-3166-2 state code (e.g. 'IN-BR').
  - `state_name` string, required: Official state name in English.
  - `capital` string, nullable: State capital city name.
  - `type` string, required: 'state' or 'union_territory'.
  - `region` string, required: Cardinal region (north / south / east / west / north-east / central).
  - `population` integer, nullable: Latest census population.
  - `area_km2` integer, nullable: Area in square kilometres.
  - `wikidata_qid` string, nullable: Wikidata QID for the state entity.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/travelminds/apis/travelmindsai-api-gateway.md) · [All operations](https://skmtc.dev/travelminds/apis/travelmindsai-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/travelminds/apis/travelmindsai-api-gateway/revisions/d05c8634e340?raw)