Lists counties, cities, towns and other jurisdictions, largest first, then by name.
Each jurisdiction includes its identifiers, the jurisdictions that contain it, and coverage, the data available for it. Boundaries are included with include=geometry or format=geojson.
Parameters
query
- latnumber | null
- Latitude, in WGS 84. Requires
lon. Results are the jurisdictions that contain the point. - lonnumber | null
- Longitude, in WGS 84. Requires
lat. - fipsstring | null
- A Census GEOID, such as
37,37183or3755000. Results are the jurisdiction with that GEOID. - statestring | null
- A state, as a postal abbreviation or FIPS code, such as
NCor37. Results are limited to jurisdictions within it. - countystring | null
- A county, as a five-digit FIPS code such as
37183, or three digits withstate. Results are limited to jurisdictions within it. - qstring | null
- A name, or the start of one. Results are ordered best match first.
- tier"national" | "region" | "subregion" | "local"[] | null
- Level of government. One of
region,subregionorlocal. Repeatable. - typestring[] | null
- Kind of jurisdiction, in local terms, such as
county,city,town,villageortownship. Repeatable. - withinstring | null
- A jurisdiction id. Results are limited to jurisdictions within it.
- includestring | null
- Comma-separated sections to include. One of
geometry(each boundary, as GeoJSON). - format"json" | "geojson"
- Response format. One of
json(a list) orgeojson(a FeatureCollection). Defaults tojson.Accept: application/geo+jsonalso selectsgeojson. - cursorstring | null
- A cursor for pagination: the
next_cursorfrom the previous page. - sizeinteger | null
- Number of results per page, between 1 and 200. Defaults to 20.
- totalboolean
- Whether to include
total, the count of all matches, on the first page. Defaults tofalse.
Responses
- 401
- ProblemDetail
credential_missing,credential_invalidorcredential_expired. The request has no valid credential.- 403
- ProblemDetail
scope_missing,person_required,api_key_not_acceptedorentitlement_missing. The credential or plan does not allow this request.detailnames the reason.- 422
- ProblemDetail
parameter_invalid,id_malformedor a cursor code. A parameter is missing or invalid.errorslists each one.- 429
- ProblemDetail
rate_limited. Too many requests. Retry after theRetry-Afterinterval. Nothing is charged.- 501
- ProblemDetail
not_available. Jurisdiction data is not available yet.
Credits
Free.
Example request
curl -G 'https://api.placestack.com/v1/jurisdiction' \
--data-urlencode 'lat=35.7796' \
--data-urlencode 'lon=-78.6382' \
-H "Authorization: Bearer $PLACESTACK_API_KEY"Example response
{
"object": "list",
"data": [
{
"object": "jurisdiction",
"id": "jur_01h455vb4pex5vsknk084sn02q",
"name": "Wake",
"legal_name": "Wake County",
"type": "county",
"tier": "national",
"country": "US",
"lifecycle_status": "active",
"fips": {
"level": "state",
"code": "37183",
"state": "37",
"county": "37183"
},
"identifiers": [
{
"scheme": "census_geoid",
"value": "37183"
}
],
"within": [
{
"id": "jur_01h455vb4pex5vsknk084sn02q",
"name": "North Carolina",
"tier": "region",
"type": "state",
"fips": "37",
"partial": false
}
],
"land_area_m2": 2162600000,
"water_area_m2": 48600000,
"centroid": {
"lat": 35.79,
"lon": -78.65
},
"coverage": {
"parcel": {
"records": 438212,
"as_of": "2026-10-01"
},
"zoning": {
"records": 438212,
"as_of": "2026-10-01"
},
"permit": {
"records": 438212,
"as_of": "2026-10-01"
},
"case": {
"records": 438212,
"as_of": "2026-10-01"
}
},
"statistics": {
"parcel": {
"parcels": 438802,
"median_market_value": 448146,
"median_acres": 0.25,
"median_year_built": 2001,
"sales_last_year": 16917,
"median_sale_price": 469226,
"land_use": [
{
"category": "residential",
"parcels": 361402
}
],
"computed": "2026-10-15"
}
},
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-78.6999,
35.849
],
[
-78.6993,
35.849
],
[
-78.6993,
35.8494
],
[
-78.6999,
35.8494
],
[
-78.6999,
35.849
]
]
]
},
"href": "/v1/jurisdiction/jur_01h455vb4pex5vsknk084sn02q"
}
],
"has_more": true,
"next_cursor": "eyJrIjoiMjAyNi0xMC0wMSIsInQiOjQyfQ",
"suppressed": 0,
"total": {
"value": 1,
"relation": "eq"
}
}