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: json

Values: 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

Request

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.county("08031");
console.log(result);
Example responsePaid plan
{
  "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].

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

Request

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"
Example response
{
  "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 tagLanguage
enEnglish
arالعربية
cacatalà
hrhrvatski
csčeština
dadansk
nlNederlands
fisuomi
frfrançais
deDeutsch
elΕλληνικά
heעברית
hiहिन्दी
humagyar
idIndonesia
ititaliano
ja日本語
ko한국어
msMelayu
nbnorsk bokmål
plpolski
ptportuguês
roromână
ruрусский
zh-Hans简体中文
skslovenčina
esespañol
svsvenska
thไทย
zh-Hant繁體中文
trTürkçe
ukукраїнська
viTiếng Việt