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/{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
idinteger
Unique identifier.
uuidstring or null

AHJID UUID (when known).

namestring

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

typeenum or null
Jurisdiction type.
countrystring

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

statestring or null

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

stateNamestring or null

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

parentCountystring or null

For sub-county jurisdictions, the containing county name.

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

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

isActiveboolean
Whether this AHJ is currently active in the catalog.
isPrivateboolean or null

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

companyIdinteger or null
For private jurisdictions, the owning company ID.
pointOfContactstring or null
submissionMethodstring or null

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

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

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

ashraeMaxTempFdouble or null

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

centroidLatitudedouble or null
centroidLongitudedouble or null
landAreaSqMilesdouble or null
specialZoneslist of strings or null
buildingDeptHourslist of strings or null
tigerYearinteger or null
funcstatstring or null
US Census functional status code.
createdAtstringformat: "date-time"
updatedAtstringformat: "date-time"
custommap from strings to any

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