Documentation menu
API reference

Jurisdictions

jurisdiction

States, counties, cities and towns, with their identifiers, boundaries and data coverage.

The jurisdiction object

objectstring
The object's type. Always jurisdiction.
idstring
A jurisdiction id.
namestring
The jurisdiction's common name.
legal_namestring
Legal name. Null when the same as name.
typestring
Kind of jurisdiction, in local terms, such as county, parish, city or town.
tierone of national, region, subregion, local
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
ISO 3166-1 alpha-2 country code.
lifecycle_statusstring
Lifecycle status. One of active, dissolved, merged or renamed.
fipsobject
Census GEOID and its parts. Null outside the US.
Show fields
levelone of state, county, county_subdivision, place
Census level. One of state, county, county_subdivision or place.
codestring
Full GEOID, such as 37, 37183 or 3755000.
statestring
Two-digit state FIPS code.
countystring
Five-digit county FIPS code. Null for a state or a place.
identifiersarray of objects
Every identifier, ordered by scheme.
Show fields
schemestring
Identifier scheme. One of census_geoid, census_geoid_fq or gnis.
valuestring
The identifier, formatted for its scheme.
withinarray of objects
The jurisdictions that contain this one, largest first.
Show fields
idstring
A jurisdiction id.
namestring
The jurisdiction's common name.
tierone of national, region, subregion, local
Level of government. One of national, region (a state or province), subregion (a county or district) or local (a city, town, village or township).
typestring
Kind of jurisdiction, in local terms, such as county, parish, city or town.
fipsstring
The Census GEOID. Null outside the US.
partialboolean
Whether the jurisdiction lies only partly inside the containing one.
land_area_m2integer
Land area, in square meters. Null when not published.
water_area_m2integer
Water area, in square meters. Null when not published.
centroidobject
A point inside the boundary. Null when not published.
Show fields
latnumber
Latitude, in WGS 84.
lonnumber
Longitude, in WGS 84.
coverageobject
Data available for the jurisdiction, by kind of record.
Show fields
parcelobject
Parcels. Null when there are none.
Show fields
recordsinteger
Number of records for the jurisdiction and every jurisdiction within it.
as_ofdate
The most recent as_of among those records.
zoningobject
Zoning classifications. Null when there are none.
Show fields
recordsinteger
Number of records for the jurisdiction and every jurisdiction within it.
as_ofdate
The most recent as_of among those records.
permitobject
Building and trade permits. Null when there are none.
Show fields
recordsinteger
Number of records for the jurisdiction and every jurisdiction within it.
as_ofdate
The most recent as_of among those records.
caseobject
Zoning and development cases. Null when there are none.
Show fields
recordsinteger
Number of records for the jurisdiction and every jurisdiction within it.
as_ofdate
The most recent as_of among those records.
statisticsobject
Figures computed from the records held for the jurisdiction.
Show fields
parcelobject
Figures from the county's parcels. Null for a jurisdiction that is not a county, and for a county with no parcels.
Show fields
parcelsinteger
Number of parcels the figures are computed from.
median_market_valueinteger
Median total market value, in US dollars. Null when no parcel has one.
median_acresnumber
Median parcel size, in acres. Null when no parcel has a boundary.
median_year_builtinteger
Median year the main building was built. Null when no parcel has one.
sales_last_yearinteger
Number of parcels whose most recent sale was in the 365 days before computed.
median_sale_priceinteger
Median price of those sales, in US dollars. Null when none has a price.
land_usearray of objects
Parcels by standard land use category, most first. Parcels with no standard land use are not counted.
Show fields
categorystring
Standard land use category, such as residential, commercial or vacant.
parcelsinteger
Number of parcels in the category.
computeddate
Date the figures were computed. They are computed again each day.
geometryobject
Boundary, as GeoJSON. Included only with include=geometry; null otherwise.
Show fields
typestring
Geometry type. One of Polygon or MultiPolygon.
coordinatesarray of anys
Coordinates, as [longitude, latitude] positions nested by geometry type.
hrefstring
The object's path in the API.

Endpoints

Next steps

GET /jurisdiction

List jurisdictions

Continue