jurisdiction

Retrieve a jurisdiction

Retrieves a jurisdiction with 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.

get/v1/jurisdiction/{jurisdiction_id}

Request

  • Base URL: http://localhost:3030
  • URL: http://localhost:3030/v1/jurisdiction/{jurisdiction_id}
  • Auth: HTTP bearer

Path parameters

jurisdiction_idstring required

Unique identifier for the jurisdiction.

Query parameters

includestring nullable

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.

Response

The jurisdiction.

object'jurisdiction' required

The object's type. Always jurisdiction.

idstring required

A jurisdiction id.

namestring required

The jurisdiction's common name.

legal_namestring nullable required

Legal name. Null when the same as name.

typestring required

Kind of jurisdiction, in local terms, such as county, parish, city or town.

tier'national' | 'region' | 'subregion' | 'local' required

Level of government. One of national, region (a state or province), subregion (a county or district) or local (a city, town, village or township).

countrystring required

ISO 3166-1 alpha-2 country code.

lifecycle_statusstring required

Lifecycle status. One of active, dissolved, merged or renamed.

land_area_m2integer nullable required

Land area, in square meters. Null when not published.

water_area_m2integer nullable required

Water area, in square meters. Null when not published.

hrefstring required

The object's path in the API.

Example response

{
  "id": "jur_01h455vb4pex5vsknk084sn02q",
  "name": "Wake",
  "legal_name": "Wake County",
  "type": "county",
  "country": "US",
  "lifecycle_status": "active",
  "fips": {
    "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"
    }
  ],
  "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"
}

Changes

No recorded changes to this operation across all 1 revision of this API.