State API

A state or province by code or name, with timezones.

Look up a state or province by code or name. /state/colorado and /state/texas resolve on their own. CA matches 12 states, so pass ?country=. ISO2, ISO3, and names all work. Accents optional.

Lookup

GET

api.parseapi.com/state/{code}

State or province by code or name. ?country= when it collides

Explore

Parameters 4

codestring · path · required: State or province code or name (NC, colorado, ontario)
countrystring · query · optional: ISO2, ISO3, or a country name. Optional when the code or name is globally unique. A collision 404s asking for it.
langstring · query · optional: Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
deepboolean · query · optional: Population, area, capital, area codes and tax references. Included on paid plans.

SDK quickstart

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.state("colorado");
console.log(result);

Run on your server with a secret key. Calling from a browser or app?

Example response

{
  "state": "CO",
  "name": "Colorado",
  "name_local": null,
  "type": "state",
  "country": "US",
  "country_name": "United States",
  "latitude": 38.725178,
  "longitude": -105.607716,
  "timezone": "America/Denver",
  "timezones": [
    "America/Denver"
  ],
  "iso_3166_2": "US-CO"
}

Response fields

state: State or province code
name: Name
name_local: Local-language name, null when absent or identical to name
type: State, province, etc.
country: ISO2 country code
country_name: Country name
latitude: Centroid latitude
longitude: Centroid longitude
timezone: Primary timezone (most-populated zone)
timezones: Every IANA timezone in the state
iso_3166_2: ISO 3166-2 code (US-CO)

Districts / counties in a state

Counties, parishes, boroughs, and the like under that state. Useful for finer address forms.

GET

api.parseapi.com/state/{code}/districts

Districts and counties in a state

Explore

Parameters 4

codestring · path · required: State / province code or name
countrystring · query · optional: ISO2, ISO3, or a country name. Optional when the code is globally unique.
langstring · query · optional: Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
deepboolean · query · optional: Population, area, capital, area codes and tax references. Included on paid plans.

SDK quickstart

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.state.districts("nc", { country: "US" });
console.log(result);

Run on your server with a secret key. Calling from a browser or app?

Example response

{
  "state": "NC",
  "state_name": "North Carolina",
  "country": "US",
  "country_name": "United States",
  "districts": [
    {
      "district": "37119",
      "name": "Mecklenburg",
      "type": "county"
    },
    {
      "district": "37063",
      "name": "Durham",
      "type": "county"
    },
    // ... 98 more
  ]
}

Response fields

state: State or province code
state_name: State or province name
country: ISO2 country code
country_name: Country name
districts: Every district in the state
districts[].district: District code
districts[].name: District name
districts[].type: County, department, etc.

Deep

?deep=true Population, area, capital, area codes and tax references. Included on paid plans.

Deep examples run with your own key. Check this API’s included units and pricing before running.

SDK quickstart

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.state("colorado", { deep: true });
console.log(result);

Run on your server with a secret key. Calling from a browser or app?

Example response

{
  "state": "CO",
  "name": "Colorado",
  "deep": {
    "tax": "Sales tax",
    "tax_rate": 2.9
  }
}

Deep fields

deep.population: Population estimate
deep.population_period: Observation year or multi-year period for this population estimate (YYYY or YYYY-YYYY). Null when the record has no verified period or population. Never the import date.
deep.area: Total area in km²
deep.fips: US Census FIPS code. Null outside the US
deep.capital: Capital or seat of government
deep.area_codes: Telephone area codes (NANP countries)
deep.tax: State or province levy name (Sales tax, HST, GST + PST). Null when unavailable or no levy is named
deep.tax_rate: State or province reference rate in percent. May already include national tax; do not add the country rate

Display language

Pass lang with a language tag such as fr, pt-BR, or zh-Hant. Existing country_name and separately sourced state or district names when available.

Omitting lang preserves the original response. Codes, IDs, numeric facts and native-name fields stay unchanged. Missing translations keep their existing source value; unknown values stay null. A preserved name_local may equal the translated name.

Send a chosen browser preference explicitly, for example { lang: navigator.language } in your JavaScript SDK options. The API does not read Accept-Language automatically. Unsupported regions fall back to their supported base language; unsupported languages or scripts use English. Empty, invalid or repeated tags return 400.

Content-Language identifies languages used in translated display fields and known English fallbacks. This option follows the current API contract. Requests selecting frozen 1.0.0 retain that contract. Select API 2.0.0 to use display language.

41 display language choices

Language tag	Language
en	American English
zh-Hans	简体中文
fr	français (France)
de	Deutsch
it	italiano
ja	日本語
ko	한국어
es	español de España
ar	العربية
bg	български
ca	català
hr	hrvatski
cs	čeština
da	dansk
nl	Nederlands
fi	suomi
el	Ελληνικά
he	עברית
hi	हिन्दी
hu	magyar
id	Indonesia
kk	қазақ тілі
ms	Melayu
nb	norsk bokmål
pl	polski
pt	português (Brasil)
ro	română
ru	русский
sk	slovenčina
sv	svenska
th	ไทย
tr	Türkçe
uk	українська
vi	Tiếng Việt
zh-Hant	繁體中文
en-AU	Australian English
en-GB	British English
fr-CA	français canadien
es-419	español latinoamericano
pt-PT	português europeu
zh-Hant-HK	繁體中文（中國香港特別行政區）

Questions? Email

State API

Lookup#

Districts / counties in a state#

Deep#

Display language#

Lookup

Districts / counties in a state

Deep

Display language