For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
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
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}).
