County API
A county by code or name, with its state and timezones.
Look up one county or equivalent area by code or name. US county FIPS, French INSEE departments, and GB GSS districts, the same codes /point and /postal hand back. /county/guilford county and /county/edinburgh resolve on their own. Type suffixes fold, so /county/guilford works too.
A name shared across counties needs ?state= or ?country=. Short state codes can also be shared across countries. For Louisiana, use its name or pair ?state=LA with ?country=US. Codes rarely collide. When one does, you get a 400 asking for country.
LookupCopy link
GET /county/{code}API Explorer ↗One county by code or name. ?state= or ?country= when it collides
Parameters
- codestring · path · required
County code or name (08031, guilford county, E09000033)
- formatstring · query · optional
json by default. geojson returns simplified administrative Polygon/MultiPolygon outlines with country-qualified IDs and selected facts in properties. Coordinates are longitude first. Missing or ambiguous outlines retain null geometry. Unavailable boundary storage returns 503. Collections retain parent context. Existing Deep access and pooled allowance apply. API 2.0.0 and later.
Default:
jsonValues:
json, geojson- countrystring · query · optional
ISO2, ISO3, or a country name. Optional when the code or name is unique.
- statestring · query · optional
ADM1 code or name. Narrows name lookups. Prefer louisiana over LA, which collides across countries, or include country=US.
- langstring · query · optional
Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
Length: 2 to 64 characters
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.county("08031");
console.log(result);{
"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"
}
}county keeps its native administrative code. iso_code contains the full ISO 3166-2 identifier when an exact recorded assignment exists, such as GB-WSM for Westminster; otherwise it is null. State county lists include the same field.
Response fields
- countyLink to countystring or null
- County code (US county FIPS, FR INSEE department, GB GSS)
- iso_codeLink to iso_codestring or null
- Full ISO 3166-2 code when an exact recorded assignment is available; null otherwise
- nameLink to namestring or null
- Name
- typeLink to typestring or null
- County, department, district, etc.
- stateLink to statestring or null
- State or province code
- state_nameLink to state_namestring or null
- State or province name
- countryLink to countrystring or null
- ISO2 country code
- country_nameLink to country_namestring or null
- Country name
- latitudeLink to latitudenumber or null
- Centroid latitude
- longitudeLink to longitudenumber or null
- Centroid longitude
- timezonesLink to timezonesarray or null
- Every IANA timezone in the county
Every county in a state instead? Use /state/{code}/counties.
GeoJSON county outlines
Add format=geojson on API 2.2.0 for a simplified Polygon or MultiPolygon Feature. Its stable id combines the country and county code, such as US-08031. The place facts and included profile fields stay in properties. Coordinates use WGS84 [longitude, latitude].
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"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"{
"type": "Feature",
"id": "US-08031",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
-104.932,
39.7
],
[
-104.934,
39.698
],
[
-104.932,
39.698
],
[
-104.932,
39.7
]
]
],
[
[
[
-105.11,
39.635
],
[
-105.108,
39.624
],
[
-105.091,
39.624
],
[
-105.091,
39.627
],
[
-105.082,
39.627
],
[
-105.084,
39.631
],
[
-105.081,
39.631
],
[
-105.076,
39.624
],
[
-105.065,
39.62
],
[
-105.097,
39.618
],
[
-105.097,
39.615
],
[
-105.091,
39.614
],
[
-105.058,
39.614
],
[
-105.057,
39.621
],
[
-105.054,
39.621
],
[
-105.056,
39.624
],
[
-105.053,
39.63
],
[
-105.06,
39.635
],
[
-105.059,
39.639
],
[
-105.053,
39.639
],
[
-105.053,
39.632
],
[
-105.044,
39.631
],
[
-105.043,
39.628
],
[
-105.025,
39.629
],
[
-105.025,
39.631
],
[
-105.035,
39.633
],
[
-105.035,
39.639
],
[
-105.03,
39.639
],
[
-105.03,
39.642
],
[
-105.035,
39.644
],
[
-105.035,
39.653
],
[
-105.032,
39.653
],
[
-105.033,
39.657
],
[
-105.023,
39.657
],
[
-105.023,
39.66
],
[
-105.016,
39.661
],
[
-105.016,
39.679
],
[
-105.009,
39.679
],
[
-105.006,
39.668
],
[
-105.011,
39.661
],
[
-105.004,
39.66
],
[
-105.004,
39.667
],
[
-105,
39.668
],
[
-104.973,
39.668
],
[
-104.969,
39.666
],
[
-104.969,
39.66
],
[
-104.959,
39.662
],
[
-104.959,
39.657
],
[
-104.954,
39.657
],
[
-104.955,
39.653
],
[
-104.932,
39.653
],
[
-104.932,
39.646
],
[
-104.922,
39.646
],
[
-104.913,
39.639
],
[
-104.913,
39.624
],
[
-104.903,
39.624
],
[
-104.885,
39.624
],
[
-104.885,
39.639
],
[
-104.88,
39.641
],
[
-104.88,
39.653
],
[
-104.875,
39.651
],
[
-104.876,
39.645
],
[
-104.847,
39.657
],
[
-104.855,
39.661
],
[
-104.866,
39.66
],
[
-104.866,
39.671
],
[
-104.871,
39.675
],
[
-104.877,
39.672
],
[
-104.876,
39.664
],
[
-104.885,
39.667
],
[
-104.89,
39.668
],
[
-104.89,
39.665
],
[
-104.894,
39.668
],
[
-104.904,
39.668
],
[
-104.904,
39.677
],
[
-104.908,
39.68
],
[
-104.905,
39.68
],
[
-104.905,
39.686
],
[
-104.903,
39.679
],
[
-104.895,
39.678
],
[
-104.894,
39.682
],
[
-104.889,
39.682
],
[
-104.889,
39.686
],
[
-104.894,
39.686
],
[
-104.894,
39.693
],
[
-104.904,
39.689
],
[
-104.904,
39.693
],
[
-104.9,
39.693
],
[
-104.904,
39.699
],
[
-104.899,
39.695
],
[
-104.878,
39.698
],
[
-104.866,
39.697
],
[
-104.868,
39.7
],
[
-104.871,
39.698
],
[
-104.866,
39.704
],
[
-104.866,
39.711
],
[
-104.871,
39.71
],
[
-104.871,
39.718
],
[
-104.875,
39.718
],
[
-104.875,
39.726
],
[
-104.882,
39.725
],
[
-104.887,
39.729
],
[
-104.885,
39.747
],
[
-104.88,
39.747
],
[
-104.88,
39.755
],
[
-104.847,
39.755
],
[
-104.856,
39.758
],
[
-104.856,
39.769
],
[
-104.833,
39.766
],
[
-104.828,
39.772
],
[
-104.782,
39.773
],
[
-104.782,
39.776
],
[
-104.772,
39.776
],
[
-104.772,
39.772
],
[
-104.765,
39.772
],
[
-104.765,
39.769
],
[
-104.735,
39.769
],
[
-104.734,
39.798
],
[
-104.763,
39.798
],
[
-104.762,
39.823
],
[
-104.666,
39.823
],
[
-104.666,
39.813
],
[
-104.655,
39.813
],
[
-104.655,
39.823
],
[
-104.62,
39.822
],
[
-104.619,
39.873
],
[
-104.605,
39.873
],
[
-104.605,
39.881
],
[
-104.6,
39.881
],
[
-104.6,
39.899
],
[
-104.631,
39.899
],
[
-104.631,
39.907
],
[
-104.68,
39.907
],
[
-104.68,
39.914
],
[
-104.692,
39.914
],
[
-104.692,
39.907
],
[
-104.703,
39.907
],
[
-104.703,
39.896
],
[
-104.73,
39.896
],
[
-104.731,
39.845
],
[
-104.791,
39.842
],
[
-104.791,
39.798
],
[
-104.866,
39.798
],
[
-104.866,
39.813
],
[
-104.884,
39.813
],
[
-104.884,
39.798
],
[
-104.904,
39.798
],
[
-104.903,
39.784
],
[
-104.927,
39.784
],
[
-104.927,
39.791
],
[
-104.94,
39.791
],
[
-104.94,
39.795
],
[
-104.969,
39.791
],
[
-104.969,
39.798
],
[
-104.975,
39.796
],
[
-104.973,
39.792
],
[
-104.976,
39.791
],
[
-105.021,
39.791
],
[
-105.022,
39.794
],
[
-105.025,
39.791
],
[
-105.064,
39.791
],
[
-105.063,
39.784
],
[
-105.053,
39.784
],
[
-105.053,
39.735
],
[
-105.056,
39.735
],
[
-105.053,
39.733
],
[
-105.053,
39.682
],
[
-105.058,
39.682
],
[
-105.058,
39.679
],
[
-105.063,
39.679
],
[
-105.063,
39.675
],
[
-105.053,
39.675
],
[
-105.053,
39.668
],
[
-105.081,
39.67
],
[
-105.081,
39.662
],
[
-105.067,
39.657
],
[
-105.071,
39.65
],
[
-105.063,
39.652
],
[
-105.057,
39.653
],
[
-105.054,
39.651
],
[
-105.074,
39.644
],
[
-105.077,
39.639
],
[
-105.073,
39.637
],
[
-105.091,
39.639
],
[
-105.091,
39.635
],
[
-105.11,
39.635
]
],
[
[
-104.908,
39.682
],
[
-104.908,
39.68
],
[
-104.911,
39.682
],
[
-104.908,
39.682
]
],
[
[
-104.904,
39.627
],
[
-104.903,
39.624
],
[
-104.904,
39.625
],
[
-104.904,
39.627
]
],
[
[
-104.941,
39.698
],
[
-104.941,
39.711
],
[
-104.932,
39.711
],
[
-104.927,
39.704
],
[
-104.934,
39.704
],
[
-104.934,
39.701
],
[
-104.929,
39.7
],
[
-104.928,
39.697
],
[
-104.934,
39.698
],
[
-104.936,
39.698
],
[
-104.936,
39.695
],
[
-104.941,
39.695
],
[
-104.939,
39.698
],
[
-104.941,
39.698
]
],
[
[
-104.932,
39.667
],
[
-104.934,
39.671
],
[
-104.932,
39.673
],
[
-104.927,
39.669
],
[
-104.932,
39.667
]
],
[
[
-104.926,
39.669
],
[
-104.927,
39.669
],
[
-104.93,
39.675
],
[
-104.926,
39.677
],
[
-104.918,
39.673
],
[
-104.913,
39.656
],
[
-104.921,
39.66
],
[
-104.921,
39.668
],
[
-104.926,
39.669
]
],
[
[
-104.899,
39.683
],
[
-104.903,
39.686
],
[
-104.899,
39.686
],
[
-104.899,
39.683
]
]
]
]
},
"properties": {
"county": "08031",
"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"
],
"iso_code": null
}
}/state/CO/counties?country=US&format=geojson returns a FeatureCollection in the existing list order. Parent country and state context stays on the collection and in each Feature's properties. Collection facts remain the same as the ordinary list. Outline collections are larger than ordinary JSON.
Coverage varies by place. An exact outline that is missing or ambiguous stays geometry: null, even when center coordinates are known. Small islands and holes may be omitted from the simplified display outline. Unavailable boundary storage returns HTTP 503. These are administrative areas. County does not provide electoral constituencies. Outlines do not establish legal borders or survey measurements.
Omit format or use format=json for the ordinary response. Existing profile access and pooled request allowances apply. Use HTTP for GeoJSON. Published SDK and MCP methods retain ordinary JSON. API 1.0.0 is unchanged.
Included dataCopy link
Population, area, the seat of government and US county property-tax medians. Included automatically on paid plans in API 2.2.
Paid plan fields
- populationLink to populationinteger or null
- Population estimate
- areaLink to areanumber or null
- Total area in km² (land + water, or the official total)
- land_areaLink to land_areanumber or null
- Land area in km² (null when the source publishes total only)
- water_areaLink to water_areanumber or null
- Water area in km² (null when the source publishes total only)
- seatLink to seatstring or null
- Seat of government (county seat, prefecture, admin centre)
- property_taxLink to property_taxobject or null
- Median annual real-estate tax payable on owner-occupied housing, in US dollars adjusted to the final year of period. Available US ZIP-area and county estimates only. Not a percentage or an individual property bill. Null when missing, censored or unsupported.
- property_tax.annual_medianLink to property_tax.annual_medianinteger
- Median annual amount in currency. Dollars adjusted to the final year of period
- property_tax.currencyLink to property_tax.currencystring
- USD
- property_tax.periodLink to property_tax.periodstring
- Observation period, such as 2020-2024
Display languageCopy link
Pass lang with a language tag such as fr, pt-BR, or zh-Hant. Existing country_name and separately sourced state or county names when available.
Omitting lang preserves the original response. Codes, IDs, numeric facts and native-name fields stay unchanged. Missing translations keep their existing source value; unknown values stay null. A preserved name_local may equal the translated name.
Send a chosen browser preference explicitly, for example { lang: navigator.language } in your JavaScript SDK options. The API does not read Accept-Language automatically. Unsupported regions fall back to their supported base language; unsupported languages or scripts use English. Empty, invalid or repeated tags return 400.
Content-Language identifies languages used in translated display fields and known English fallbacks. Display language is available on API 2.1.0; requests selecting frozen 1.0.0 retain their original contract. See API versions.
33 display language choices
| Language tag | Language |
|---|---|
| en | English |
| ar | العربية |
| ca | català |
| hr | hrvatski |
| cs | čeština |
| da | dansk |
| nl | Nederlands |
| fi | suomi |
| fr | français |
| de | Deutsch |
| el | Ελληνικά |
| he | עברית |
| hi | हिन्दी |
| hu | magyar |
| id | Indonesia |
| it | italiano |
| ja | 日本語 |
| ko | 한국어 |
| ms | Melayu |
| nb | norsk bokmål |
| pl | polski |
| pt | português |
| ro | română |
| ru | русский |
| zh-Hans | 简体中文 |
| sk | slovenčina |
| es | español |
| sv | svenska |
| th | ไทย |
| zh-Hant | 繁體中文 |
| tr | Türkçe |
| uk | українська |
| vi | Tiếng Việt |