Counties · Departments · Districts

County API

Turn a code or name
into a place.

Resolve a county or comparable area to its name, state, country and timezones. Match location records and build county selectors with the same API key.

Try it

Run example (Command+Enter or Ctrl+Enter)
Example response/county/08031
{
  "county": "08031",
  "iso_code": null,
  "name": "Denver County",
  "type": "county",
  "state": "CO",
  "state_name": "Colorado",
  "country": "US",
  "country_name": "United States",
  "latitude": 39.76185,
  "longitude": -104.881105,
  
    "America/Denver"
  ],
  "population": 729019,
  "area": 400.74,
  "land_area": 396.46,
  "water_area": 4.28,
  "seat": "Denver",
  
    "annual_median": 2751,
    "currency": "USD",
    "period": "2020-2024"
  }
}

Highlighted fields: Included on paid plans.

From your records to your interface

Codes for your app.
Names for your customers.

Look up one place or list the counties 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/county/08031" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Version: 2.2.0"

Example response

JSON200 OK
{
  "county": "08031",
  "iso_code": null,
  "name": "Denver County",
  "type": "county",
  "state": "CO",
  "state_name": "Colorado",
  "country": "US",
  "country_name": "United States",
  "latitude": 39.76185,
  "longitude": -104.881105,
  "timezones": [
    "America/Denver"
  ],
  "population": 729019,
  "area": 400.74,
  "land_area": 396.46,
  "water_area": 4.28,
  "seat": "Denver",
  "property_tax": {
    "annual_median": 2751,
    "currency": "USD",
    "period": "2020-2024"
  }
}

Highlighted fields: Included on paid plans.

Full API reference

GeoJSON outlines

Draw the place.

Put county and district boundaries on your map.

Choose a place to load its outline.Drag to pan · + / - to zoom
County GeoJSON · HTTP
curl "https://api.parseapi.com/county/08031?country=US&format=geojson" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Version: 2.2.0"

GeoJSON reference

Included on paid plans

Put the place
in context.

Add population and area to a location profile, or read the seat of government for a directory. Paid plans include available detail automatically in the same lookup.

/county/08031

Denver County, Colorado
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 counties for a selector, then look up the selected county with the same key.

HTTP, SDKs and MCP

Copy a request above, use the County method in your language, or bring the lookup to your agent through MCP.

Use Postal for a county code from a ZIP or postcode, or Point for a county at a coordinate.

Before you build.

Which places and codes are covered?

County 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 /county/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 county in a state?

Yes. GET /state/{code}/counties returns the recorded counties and comparable areas with their codes, names and types. Add country when the state code is shared. Paid plans automatically include available population on each result.

What do paid plans include?

Paid plans automatically include available population, total area, land and water area in square kilometers, the seat of government, and US property-tax statistics. The ordinary fields stay unchanged. Free returns the ordinary answer without the optional fields.

How should I interpret coordinates and timezones?

Coordinates describe the area center. timezones lists the recorded IANA zones in the area, including places that span more than one zone. A single-zone area 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?

County identifies administrative areas such as counties and departments. Its county field is the administrative code. It does not identify congressional constituencies.

How is County priced?

Each lookup or state county-list request uses one API request from your shared ParseAPI allowance. Core works on every plan. Paid profile detail is included automatically in that same request, with no additional per-field or per-record charge.

Start with a ZIP? Try the county by ZIP tool.

County API pricing

Put the place
in your app.

Place identity on every plan. Profile detail included automatically on paid plans. Your API request allowance is shared across ParseAPI products.

Free

Start free

Try County with a free API key.

Room to grow

See plans

Choose the volume your app needs.