A code or name for the state record. /districts for every district or county in it.

Not when the code or name is unique. colorado and texas resolve on their own. CA matches 12 states, so pass ?country=US. Country takes ISO2, ISO3, or a name.

Name, type, capital, timezones, area codes, sales tax and its rate, FIPS in the US, population, and area.

The kind of division. State, province, prefecture, oblast.

GET /state/{code} · /{code}/districts

State API

Pass colorado, texas, or ontario. Capital, tax, area codes, timezones.

You have a code or a name. Capital, tax, area codes.

name

Name

type

State, province, etc.

capital

Capital or seat of government

timezones

Every IANA timezone in the state

area_codes

Telephone area codes (NANP countries)

tax

Standard sales tax name (Sales tax, HST). Null when the state levies none

tax_rate

Standard sales tax rate, percent

fips

US Census FIPS code. Null outside the US

districts

Every district in the state

Pass a code or the name

/state/colorado and /state/texas resolve on their own. CA needs ?country=US.

Get the facts

Name, capital, timezones, area codes, the sales tax and its rate, FIPS in the US.

List districts

Districts hang off the state path.

5,308 states.

Address forms. Every plan.

229
countries covered: 5,308
states and provinces: 3,680
districts listed

Look up a state or province by code or name. /state/colorado and /state/texas resolve on their own. CA matches twelve states, so pass ?country=US. Country takes ISO2, ISO3, or a name.

Capital, timezones, area codes, and the sales tax ride every record. Need districts or counties under it? Use /state/{code}/districts.

RESPONSE

$ curl "https://api.parseapi.com/state/colorado" \
  -H "X-API-Key: YOUR_API_KEY"

// 200 · ~35ms US · ~97ms worldwide
{
  "state": "CO",
  "name": "Colorado",
  "local_name": "Colorado",
  "type": "state",
  "country": "US",
  "country_name": "United States",
  "latitude": 38.725178,
  "longitude": -105.607716,
  "population": 5957493,
  "area": 269837,
  "timezone": "America/Denver",
  "timezones": ["America/Denver"],
  "iso_3166_2": "US-CO",
  "fips": "08",
  "capital": "Denver",
  "area_codes": ["303", "719", "720", "970"],
  "tax": "Sales tax",
  "tax_rate": 2.9
}

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: Total area in km²
timezone: Primary timezone (most-populated zone)
timezones: Every IANA timezone in the state
iso_3166_2: ISO 3166-2 code (US-CO)
fips: US Census FIPS code. Null outside the US
capital: Capital or seat of government
area_codes: Telephone area codes (NANP countries)
tax: Standard sales tax name (Sales tax, HST). Null when the state levies none
tax_rate: Standard sales tax rate, percent

QUESTIONS

When do I use which?: A code or name for the state record. /districts for every district or county in it.
Do I need a country?: Not when the code or name is unique. colorado and texas resolve on their own. CA matches 12 states, so pass ?country=US. Country takes ISO2, ISO3, or a name.
What comes back?: Name, type, capital, timezones, area codes, sales tax and its rate, FIPS in the US, population, and area.
What is type?: The kind of division. State, province, prefecture, oblast.
How do I list every state in a country?: GET /country/{code}/states.
How do I list districts?: They hang off the state path.

SPEED

How long /state takes.

11ms

12ms

APAC

42ms

LatAm

10ms

90ms

See live status →

Coverage

Official admin divisions in 229 countries.

NANorth America38 countries
EUEurope50 countries
AFAfrica57 countries
ASAsia48 countries
OCOceania22 countries
SASouth America13 countries
ANAntarctica1 countries

All 50 two-letter codes plus DC and territories in the abbreviations list.

Get started Docs