ahJs

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}).

get/ahjs

Request

Base URL: https://api.coperniq.io/v1
URL: https://api.coperniq.io/v1/ahjs
Auth: API key in header x-api-key

Query parameters

page_sizeinteger

Number of items per page (max 100)

pageinteger

Page number (1-based)

qstring

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

statestring

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

Filter by jurisdiction type.

countrystring

Filter by country code.

order_by'asc' | 'desc'

Sort order for results

latnumber double

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

lngnumber double

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

Response

List of AHJs

idinteger

Unique identifier.

uuidstring nullable

AHJID UUID (when known).

namestring

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

Jurisdiction type.

countrystring

Two-letter country code (e.g. "US").

statestring nullable

Two-letter state code (e.g. "CA").

stateNamestring nullable

Full state name (e.g. "California").

parentCountystring nullable

For sub-county jurisdictions, the containing county name.

geoIdstring nullable

US Census TIGER GEOID for the boundary.

ahjRegistryCodestring nullable

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

isActiveboolean

Whether this AHJ is currently active in the catalog.

isPrivateboolean nullable

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

pointOfContactstring nullable

submissionMethodstring nullable

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

emailsstring[]

phonesstring[]

addressstring nullable

websitestring nullable

portalstring nullable

Permit portal URL.

turnaroundinteger nullable

Typical permit turnaround in days.

feesstring nullable

notesstring nullable

permitSubmissionNotesstring nullable

buildingCodeModelstring nullable

buildingCodeLocalstring nullable

residentialCodeModelstring nullable

residentialCodeLocalstring nullable

fireCodeModelstring nullable

fireCodeLocalstring nullable

electricalCodeModelstring nullable

electricalCodeLocalstring nullable

windCodeModelstring nullable

windCodeLocalstring nullable

codesOtherstring nullable

firePathwaysEnforcedboolean nullable

electricalEngineerStampRequiredboolean nullable

structuralStampRequiredboolean nullable

climateZonestring nullable

ashraeMinTempCnumber double nullable

ashraeMaxTempCnumber double nullable

ashraeMinTempFnumber double nullable

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

ashraeMaxTempFnumber double nullable

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

centroidLatitudenumber double nullable

centroidLongitudenumber double nullable

landAreaSqMilesnumber double nullable

specialZonesstring[] nullable

buildingDeptHoursstring[] nullable

tigerYearinteger nullable

funcstatstring nullable

US Census functional status code.

createdAtstring date-time

updatedAtstring date-time

customobject

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.

Changes

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