Read-only JSON API
Every Indian city, one request away.
Reference data for state capitals and major metros: filter, look up, find the nearest, measure distance.
—cities
—states and territories
6endpoints
—last response
Endpoints
GET/v1/cities
List cities. Filter by state, tier, tag or free text; page with limit and offset.
GET/v1/cities/{id}
One city by its id, with coordinates, population, tier and tags.
GET/v1/states
Every state and territory in the dataset, ranked by combined population.
GET/v1/nearest
The closest cities to any coordinate, with distance and bearing.
GET/v1/distance
Great-circle distance between two cities in kilometres.
GET/v1/whoami
A receipt for the request: time, request id, and the device that answered.