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. Get the seat and place.

name

Name

type

County, department, district, etc.

seat

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

state

State or province code

country

ISO2 country code

timezone

Primary timezone (most-populated zone)

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, seat, state, timezones, area. Add state when a name collides.

List a state

Every district in a state hangs off the state path.

3,680 districts.

US, FR, GB. Every plan.

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, a GB district. Pass a FIPS, INSEE, or GSS code, or the name. /district/guilford county and /district/edinburgh resolve on their own. Type suffixes fold away.

Seat, timezones, and land area ride every record. A name shared across districts needs ?state= or ?country=. Want every district in a state? Use /state/{code}/districts.

RESPONSE

$ curl "https://api.parseapi.com/district/08031" \
  -H "X-API-Key: YOUR_API_KEY"

// 200 · ~35ms US · ~97ms worldwide
{
  "district": "08031",
  "name": "Denver County",
  "type": "county",
  "state": "CO",
  "state_name": "Colorado",
  "country": "US",
  "country_name": "United States",
  "latitude": 39.76185,
  "longitude": -104.881105,
  "population": 729019,
  "area": 400.74,
  "land_area": 396.46,
  "water_area": 4.28,
  "seat": "Denver",
  "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
population: Population estimate
area: Total area in km² (land + water, or the official total)
land_area: Land area in km² (null when the source publishes total only)
water_area: Water area in km² (null when the source publishes total only)
seat: Seat of government (county seat, prefecture, admin centre)
timezone: Primary timezone (most-populated zone)
timezones: Every IANA timezone in the district

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, seat, state, timezones, population, and land 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.

SPEED

How long /district takes.

11ms

12ms

APAC

58ms

LatAm

10ms

122ms

See live status →

Coverage

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

United States
France
United Kingdom

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

Get started Docs