GET /district/{code}

District API

Pass a FIPS, INSEE, GSS code, or the name. Identify the district.

Try it

Example response/district/08031
{
  "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",
  
    "America/Denver"
  ],
  ?deep=true
}

1M requests · $20/mo. Get started

What comes back.

name

Name

type

County, department, district, etc.

deep.seat

Seat of government (county seat, prefecture, admin centre)

state

State or province code

country

ISO2 country code

timezone

Primary timezone (most-populated zone)

deep.area

Total area in km² (land + water, or the official total)

1

Pass a code or the name

/district/guilford county. Type suffixes fold away.

2

Get the place

Name, state, coordinates, and timezones. Paid deep adds the seat and statistics. Add state when a name collides.

3

List a state

Every district in a state hangs off the state path.

Make your first request.

One key works across the APIs. Copy a request in your language and get JSON back.

curl "https://api.parseapi.com/district/08031" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Parse-Version: 2.0.0"
// Example response · 200
{
  "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"]
}

API referenceSDKsKeys and authentication

Every response field

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

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.periodstring
Observation period, such as 2020-2024

QUESTIONS

What is a district?
The layer under a state. A US county, a French department, a GB district. Pass a FIPS, INSEE, or GSS code, or the name. /district/guilford county works.
What comes back?
Name, type, state, country, coordinates, and timezones. Paid deep adds the seat, population, and area.
How do I list them?
GET /state/{code}/districts.
Which codes?
US FIPS county, French INSEE department, GB GSS district.
When do I pass state or country?
When a name collides. washington matches 31 districts. ?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.

Look up the county behind a ZIP with the county by ZIP tool.