Counties · Departments · Districts
District API
Turn a code or name
into a place.
Resolve a county or district to its name, state, country and timezones. Match location records and build county selectors with the same API key.
Try it
From your records to your interface
Codes for your app.
Names for your customers.
Look up one place or list the districts in a state. Choose a task to see its request and complete JSON.
A county code becomes a place.
Denver County by its five-digit FIPS code. Keep the code for matching records and the names for your interface. Leading zeros stay intact.
Request
curl "https://api.parseapi.com/district/08031?deep=true" \
-H "X-API-Key: YOUR_API_KEY"Example response
GeoJSON outlines
Draw the place.
Put county and district boundaries on your map.
curl "https://api.parseapi.com/district/08031?country=US&format=geojson" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Parse-Version: 2.0.0"Optional Deep
Put the place
in context.
Add population and area to a location profile, or read the seat of government for a directory. Deep adds available detail to the same lookup.
/district/08031?deep=true
- Population
- 729,019
- Total area
- 400.74 km2
- County seat
- Denver
Coverage
Three countries.
One place to look.
County and district reference data for the US, France and Great Britain. Available detail varies by place. Missing facts stay null.
- United States
- France
- Great Britain
- US counties and equivalents
- Five-digit FIPS codes identify counties, parishes, boroughs and other county equivalents.
- French departments
- INSEE department codes resolve to the department and its region.
- Great Britain districts
- GSS district codes resolve to the recorded administrative place in England, Scotland or Wales.
From your first request to your application
Build it into
your app.
Send a code or name over HTTP or use your SDK. List a state's districts for a selector, then look up the selected place with the same key.
HTTP, SDKs and MCP
Copy a request above, use the District method in your language, or bring the lookup to your agent through MCP.
Use Postal for a district code from a ZIP or postcode, or Point for a district at a coordinate.
Before you build.
Which places and codes are covered?
District covers US counties and county equivalents by FIPS code, French departments by INSEE code, and Great Britain districts by GSS code. Names work too. Available profile fields vary by place, and missing facts remain null.
What happens when a name is shared?
The API asks you to narrow the lookup instead of selecting a place for you. Pass country and state, for example /district/washington?country=US&state=RI. A code shared across countries returns 400 asking for country. A shared name returns 404 asking for a more specific lookup.
Can I list every district in a state?
Yes. GET /state/{code}/districts returns the recorded districts with their codes, names and types. Add country when the state code is shared. Paid Deep adds available population to each district.
What does Deep add?
On a paid plan, add deep=true for population, total area, land and water area in square kilometers, the seat of government, and available US property-tax statistics. The ordinary fields stay unchanged. Free returns the ordinary answer with deep: {}.
How should I interpret coordinates and timezones?
Coordinates describe the district center. timezones lists the recorded IANA zones in the district, including places that span more than one zone. A single-zone district returns a one-item list. Missing timezone data stays null. Use Point to find the timezone at an exact coordinate. District codes are strings, so preserve leading zeros such as 08031.
What does property_tax measure?
It is the median annual real-estate tax payable on owner-occupied homes in a supported US county, with its currency and observation period. It is an area statistic. It does not give a tax percentage or the bill for a particular property. Missing or unsupported estimates stay null.
Is this a congressional district lookup?
District identifies administrative areas such as counties and departments. Its district field is the administrative code. It does not identify congressional constituencies.
How is District priced?
Each lookup or state district-list request uses one API request from your shared ParseAPI allowance. Core works on every plan. Deep is included on paid plans in that same request, with no additional per-field or per-record charge.
Start with a ZIP? Try the county by ZIP tool.
District API pricing
Put the place
in your app.
Core on every plan. Deep included on paid plans. Your API request allowance is shared across ParseAPI products.
Free
Start free
Try District with a free API key.
Room to grow
See plans
Choose the volume your app needs.