APIs/State

State API

GET /state/{code}?country={iso2}

Look up a state or province by code. Codes are not unique globally, so pass ?country= too.

Need districts or counties under it? Use /state/{code}/districts?country={country} for address forms and anything below the country level.

5,308
states & provinces
229
countries covered
102
subdivision types
99.8%
with ISO 3166-2

Try it

$ curl "https://api.parseapi.com/state/nc?country=US" \
  -H "X-API-Key: YOUR_API_KEY"

// 200 · ~13ms · USA
{
  "state": "NC",
  "name": "North Carolina",
  "local_name": "North Carolina",
  "type": "state",
  "country": "US",
  "country_name": "United States",
  "latitude": 35.5,
  "longitude": -79.8,
  "population": 10439388,
  "area": 139391,
  "timezone": "America/New_York"
}

Response fields

state
State or province code
name
Name
local_name
Local-language name
type
State, province, etc.
country
ISO2 country code
country_name
Country name
latitude
Centroid latitude
longitude
Centroid longitude
population
Population estimate
area
Land area in km²
timezone
Primary timezone

SPEED

Fast from everywhere.

Median time for a /state response to reach a real city, first byte back, measured live from 16 cities. Not a lab benchmark. The whole trip.

US

13ms

EU

17ms

APAC

44ms

LatAm

16ms

ME

127ms

See live status →

Create a free keyDocs