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=. Washington matches 31. ?state=LA itself matches 11 ADM1 codes, so prefer louisiana or pair it 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 (washington matches 31 districts). Prefer louisiana over LA, which collides across countries.
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, 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

district: District code (US county FIPS, FR INSEE department, GB GSS)
name: Name
type: County, department, district, etc.
state: State or province code
state_name: State or province name
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 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.

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.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": null
  }
}

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² (land + water, or the official total)
deep.land_area: Land area in km² (null when the source publishes total only)
deep.water_area: Water area in km² (null when the source publishes total only)
deep.seat: Seat of government (county seat, prefecture, admin centre)
deep.property_tax: 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_median: Median annual amount in currency. Dollars adjusted to the final year of period
deep.property_tax.currency: USD
deep.property_tax.period: 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