Retrieve a jurisdiction · API reference

A jurisdiction, with its identifiers, the jurisdictions that contain it, and coverage, the data available for it.

A jurisdiction's id stays the same when its name or boundary changes. The boundary is included with include=geometry or format=geojson.

Free.

Parameters

path

jurisdiction_idrequiredstring: Unique identifier for the jurisdiction.

query

includestring | null: Comma-separated sections to include. One of geometry (the boundary, as GeoJSON).
format"json" | "geojson": Response format. One of json (the object) or geojson (a Feature). Defaults to json. Accept: application/geo+json also selects geojson.

Responses

200: jurisdiction object; The jurisdiction.
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.
404: ProblemDetail; no_such_resource. No jurisdiction has this id.
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.

Example request

curl -X GET 'https://api.placestack.com/v1/jurisdiction/jur_01h455vb4pex5vsknk084sn02q' \
  -H "Authorization: Bearer $PLACESTACK_API_KEY"

Example response

{
  "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"
    },
    "application": {
      "records": 438212,
      "as_of": "2026-10-01"
    }
  },
  "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"
}