District API

One district by code. US, French, and GB schemes.

Look up one district by code. US county FIPS, French INSEE departments, and GB GSS districts, the same codes /point and /postal hand back in their district field when that country is seeded.

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. Japan postal returns the place name, with the district code left empty.

Lookup

GET

api.parseapi.com/district/{code}

One district by code

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

{
  "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

Every district in a state instead? Use /state/{code}/districts.

Questions? Email