District API

A district by code or name, with its state and timezones.

Look up one district by code or name. US county FIPS, French INSEE departments, and GB GSS districts, the same codes /point and /postal hand back. /district/guilford county and /district/edinburgh resolve on their own. Type suffixes fold, so /district/guilford works too.

A name shared across districts needs ?state= or ?country=. Short state codes can also be shared across countries. For Louisiana, use its name or pair ?state=LA with ?country=US. Codes rarely collide. When one does, you get a 400 asking for country.

Lookup

GET

api.parseapi.com/district/{code}

One district by code or name. ?state= or ?country= when it collides

Explore

Parameters 5

codestring · path · required

District code or name (08031, guilford county, E09000033)

countrystring · query · optional

ISO2, ISO3, or a country name. Optional when the code or name is unique.

statestring · query · optional

ADM1 code or name. Narrows name lookups. Prefer louisiana over LA, which collides across countries, or include country=US.

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.

Length: 2 to 64 characters

deepboolean · query · optional

Population, area, the seat of government and US county property-tax medians. Included on paid plans.

SDK quickstart

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

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.district("08031");
console.log(result);

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

Example response

{
  "district": "08031",
  "name": "Denver County",
  "type": "county",
  "state": "CO",
  "state_name": "Colorado",
  "country": "US",
  "country_name": "United States",
  "latitude": 39.76185,
  "longitude": -104.881105,
  "timezone": "America/Denver",
  "timezones": [
    "America/Denver"
  ]
}

Response fields

districtstring or null: District code (US county FIPS, FR INSEE department, GB GSS)
namestring or null: Name
typestring or null: County, department, district, etc.
statestring or null: State or province code
state_namestring or null: State or province name
countrystring or null: ISO2 country code
country_namestring or null: Country name
latitudenumber or null: Centroid latitude
longitudenumber or null: Centroid longitude
timezonestring or null: Primary timezone (most-populated zone)
timezonesarray or null: Every IANA timezone in the district

Every district in a state instead? Use /state/{code}/districts.

Deep

?deep=true Population, area, the seat of government and US county property-tax medians. Included on paid plans.

Run this Deep example with a paid-plan key. Deep is included in the pooled request, with no separate lookup charge.

SDK quickstart

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

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

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

Example response

{
  "district": "08031",
  "name": "Denver County",
  "type": "county",
  "state": "CO",
  "state_name": "Colorado",
  "country": "US",
  "country_name": "United States",
  "latitude": 39.76185,
  "longitude": -104.881105,
  "timezone": "America/Denver",
  "timezones": [
    "America/Denver"
  ],
  "deep": {
    "population": 729019,
    "population_period": null,
    "area": 400.74,
    "land_area": 396.46,
    "water_area": 4.28,
    "seat": "Denver",
    "property_tax": {
      "annual_median": 2751,
      "currency": "USD",
      "period": "2020-2024"
    }
  }
}

Deep fields

deep.populationinteger or null: Population estimate
deep.population_periodstring or null: 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.areanumber or null: Total area in km² (land + water, or the official total)
deep.land_areanumber or null: Land area in km² (null when the source publishes total only)
deep.water_areanumber or null: Water area in km² (null when the source publishes total only)
deep.seatstring or null: Seat of government (county seat, prefecture, admin centre)
deep.property_taxobject or null: Median annual real-estate tax payable on owner-occupied housing, in US dollars adjusted to the final year of period. Available US ZIP-area and county estimates only. Not a percentage or an individual property bill. Null when missing, censored or unsupported.
deep.property_tax.annual_medianinteger: Median annual amount in currency. Dollars adjusted to the final year of period
deep.property_tax.currencystring: USD
deep.property_tax.periodstring: Observation period, such as 2020-2024

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

District API

Lookup#

Deep#

Display language#

Lookup

Deep

Display language