APIs/District

District API

GET /district/{code}

A district is the layer under a state: a US county, a French department, a GB district. /point and /postal already hand back a district code (FIPS, INSEE, or GSS) when they can resolve one, this endpoint turns that code into a name, state, and place. Most codes are unique across schemes, so a bare lookup is enough.

US FIPS and Japan JIS city codes are both 5-digit and can collide. When a code exists in more than one country, pass ?country= (you get a 400 asking for it). Postal only ships a district code when this endpoint can resolve it for that country. Want every district in a state instead? Use /state/{code}/districts.

3,680
districts
US · FR · GB
countries
postal
ships resolvable codes only

Try it

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

// 200 · ~16ms · USA
{
  "district": "37081",
  "name": "Guilford County",
  "type": "county",
  "state": "NC",
  "state_name": "North Carolina",
  "country": "US",
  "country_name": "United States",
  "latitude": 36.079,
  "longitude": -79.788,
  "population": 541299,
  "land_area": 1670610000,
  "water_area": 24700000
}

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
land_area
Land area in square meters
water_area
Water area in square meters

SPEED

Fast from everywhere.

Median time for a core lookup to reach a real city, first byte back, measured live from 16 cities.

US

16ms

EU

19ms

APAC

45ms

LatAm

20ms

ME

127ms

See live status →

Coverage

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

  • United States
  • France
  • United Kingdom
Create a free keyDocs