Skip to navigation
API ReferenceAHJs

List AHJs

Retrieve a paginated list of Authorities Having Jurisdiction (AHJs).

Supports:

  • Pagination (page_size, page)
  • Sorting by name (order_by, default: asc)
  • Search by name or state code (q) — when q is exactly two characters it also matches the two-letter state code
  • Filter by state (two-letter code), type, and country (default: US)
  • Geo mode: pass lat+lng (together) to return every AHJ whose boundary covers the point — e.g. city, county, and state — ordered most-specific-first. Name/state/type filters are ignored, and an empty array is returned if none cover the point.

Only active jurisdictions are returned. AHJs are seeded globally from the US Census TIGER catalog plus per-company private records. Most fields are read-only; only custom fields can be updated (see PATCH /ahjs/{ahj_id}).

Authentication

x-api-keystring
API Key authentication via header

Query parameters

page_sizeintegerOptional1-100Defaults to 20

Number of items per page (max 100)

pageintegerOptional>=1Defaults to 1

Page number (1-based)

qstringOptional

Search by AHJ name (case-insensitive). If exactly two characters, also matches the state code.

statestringOptional=2 characters

Filter by two-letter state code (e.g. “CA”).

typeenumOptional
Filter by jurisdiction type.
countrystringOptionalDefaults to US
Filter by country code.
order_byenumOptionalDefaults to asc
Sort order for results
Allowed values:
latdoubleOptional-90-90

Latitude in decimal degrees. Must be used together with lng.

lngdoubleOptional-180-180

Longitude in decimal degrees. Must be used together with lat.

Response

List of AHJs
idintegerOptional
Unique identifier.
uuidstring or nullOptional

AHJID UUID (when known).

namestringOptional

Full AHJ name (e.g. “City of San Francisco”).

typeenum or nullOptional
Jurisdiction type.
countrystringOptional

Two-letter country code (e.g. “US”).

statestring or nullOptional

Two-letter state code (e.g. “CA”).

stateNamestring or nullOptional

Full state name (e.g. “California”).

parentCountystring or nullOptional

For sub-county jurisdictions, the containing county name.

geoIdstring or nullOptional
US Census TIGER GEOID for the boundary.
ahjRegistryCodestring or nullOptional

AHJ Registry composite code (e.g. “TX-4805000”).

isActivebooleanOptional
Whether this AHJ is currently active in the catalog.
isPrivateboolean or nullOptional

True for company-private jurisdictions, false for global catalog entries.

pointOfContactstring or nullOptional
submissionMethodstring or nullOptional

How permit submissions are accepted (online, in-person, etc.).

emailslist of stringsOptional
phoneslist of stringsOptional
addressstring or nullOptional
websitestring or nullOptional
portalstring or nullOptional
Permit portal URL.
turnaroundinteger or nullOptional
Typical permit turnaround in days.
feesstring or nullOptional
notesstring or nullOptional
permitSubmissionNotesstring or nullOptional
buildingCodeModelstring or nullOptional
buildingCodeLocalstring or nullOptional
residentialCodeModelstring or nullOptional
residentialCodeLocalstring or nullOptional
fireCodeModelstring or nullOptional
fireCodeLocalstring or nullOptional
electricalCodeModelstring or nullOptional
electricalCodeLocalstring or nullOptional
windCodeModelstring or nullOptional
windCodeLocalstring or nullOptional
codesOtherstring or nullOptional
firePathwaysEnforcedboolean or nullOptional
electricalEngineerStampRequiredboolean or nullOptional
structuralStampRequiredboolean or nullOptional
climateZonestring or nullOptional
ashraeMinTempCdouble or nullOptional
ashraeMaxTempCdouble or nullOptional
ashraeMinTempFdouble or nullOptional

Auto-computed from ashraeMinTempC. Used for NEC 690.7 max-Voc string sizing.

ashraeMaxTempFdouble or nullOptional

Auto-computed from ashraeMaxTempC. Used for thermal derating in PV performance modeling.

centroidLatitudedouble or nullOptional
centroidLongitudedouble or nullOptional
landAreaSqMilesdouble or nullOptional
specialZoneslist of strings or nullOptional
buildingDeptHourslist of strings or nullOptional
tigerYearinteger or nullOptional
funcstatstring or nullOptional
US Census functional status code.
createdAtstringOptionalformat: "date-time"
updatedAtstringOptionalformat: "date-time"
custommap from strings to anyOptional

Custom field values keyed by property keyName. This includes only customer-defined custom columns (see GET /properties?record_type=ahj). Built-in catalog AHJ fields (turnaround, website, fees, notes, etc.) are exposed as top-level fields on the AHJ object and are read-only.

Errors

400
Bad Request Error
401
Unauthorized Error
502
Bad Gateway Error