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.

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.

GET /district/{code}

District API

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

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)

Pass a code or the name

/district/guilford county. Type suffixes fold away.

Get the place

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

List a state

Every district in a state hangs off the state path.

Coverage

Three countries seeded today. Bare codes usually resolve. Pass ?country= when a code collides.

United States
France
United Kingdom

3,680
districts: 3,222
US counties: 108
French departments: 350
GB districts

A district is the layer under a state: a US county, a French department, or a GB district. Pass a FIPS, INSEE, GSS code, or name. Type suffixes fold away.

Get its identity, state, country, coordinates, and timezones. Paid deep adds the seat, population, and area. A shared name needs state or country. /state/{code}/districts lists the districts in a state.

SPEED

How long /district takes.

Median time to first byte over the last seven days. Warm requests, measured every 30 minutes. Live verification and other request variants can take longer.

22ms

24ms

APAC

38ms

LatAm

26ms

88ms

See live status →

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 reference SDKs Keys and authentication

Every response field

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

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

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.

Find the district.

US, French, and British districts on every plan. Place statistics on paid plans.

Start includes 1M API requests a month for $20/mo.

Get started Compare plans Read the docs