Documentation menu

← Jurisdictions

API reference

List jurisdictions

GET/v1/jurisdiction

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, 37183 or 3755000. Results are the jurisdiction with that GEOID.
statestring | null
A state, as a postal abbreviation or FIPS code, such as NC or 37. Results are limited to jurisdictions within it.
countystring | null
A county, as a five-digit FIPS code such as 37183, or three digits with state. 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, subregion or local. Repeatable.
typestring[] | null
Kind of jurisdiction, in local terms, such as county, city, town, village or township. 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) or geojson (a FeatureCollection). Defaults to json. Accept: application/geo+json also selects geojson.
cursorstring | null
A cursor for pagination: the next_cursor from 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 to false.

Responses

200
array of jurisdiction objects
A page of jurisdictions.
401
ProblemDetail
credential_missing, credential_invalid or credential_expired. The request has no valid credential.
403
ProblemDetail
scope_missing, person_required, api_key_not_accepted or entitlement_missing. The credential or plan does not allow this request. detail names the reason.
422
ProblemDetail
parameter_invalid, id_malformed or a cursor code. A parameter is missing or invalid. errors lists each one.
429
ProblemDetail
rate_limited. Too many requests. Retry after the Retry-After interval. 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"
  }
}

Next steps

GET /jurisdiction/{jurisdiction_id}

Retrieve a jurisdiction

Continue