GET
/
permits
/
search

Authorizations

X-API-Key
string
header
required

Query Parameters

permit_has_contractor
boolean | null

Return only records that have a contractor ID.

permit_from
string
required

Return permits that started on or after the specified date.This includes all permits with the earliest date (file, issue, or start date) that falls on or after this date. Date format: YYYY-MM-DD

permit_to
string
required

Return permits that started on or before the specified date.This includes all permits with the latest date (file, issue, or end date) that falls on or before this date. Date format: YYYY-MM-DD

permit_q
string | null

The keyword or phrase to search for in permit description.

Maximum length: 50
permit_status
string[] | null

Filter by one or more statuses: final, in_review, inactive, active.

permit_min_approval_duration
integer | null

Filter by the minimum permit approval duration in days.

permit_min_construction_duration
integer | null

Filter by the minimum project construction duration in days.

permit_min_inspection_pr
integer | null

Filter by the minimum inspection pass rate.

permit_min_job_value
integer | null

Filter by the minimum job value.

permit_min_fees
integer | null

Filter by minimum permit fees.

permit_tags
string[] | null

Filter by one or more tags.

geo_id
string
required

Filter by the geolocation ID: address, city, zip code, county, etc.

property_type
string | null

Filter by property type: residential, commercial, industrial, agricultural, vacant land, exempt, miscellaneous, office, recreational.

property_min_market_value
integer | null

Minimum assessed market value of the property.

property_min_building_area
integer | null

Minimum total building area in sq ft.

property_min_lot_size
integer | null

Minimum size of the property lot in sq ft.

property_min_story_count
integer | null

Minimum number of property stories.

property_min_unit_count
integer | null

Minimum number of property units

contractor_classifications
string[] | null

State license board classification or other certification codes.

contractor_name
string | null

Filter by contractor's name or part of their name.

contractor_website
string | null

Filter by contractor's website. Don't include the http(s):// prefix.

contractor_min_total_job_value
integer | null

Minimum lifetime job value of the contractor.

contractor_min_total_permits_count
integer | null

Minimum lifetime permits count.

contractor_min_inspection_pr
number | null

Minimum lifetime inspection pass rate.

contractor_license
string | null

Filter by the contractor's license

page
integer
default:
1
Required range: x > 1
size
integer
default:
50
Required range: 1 < x < 100

Response

200 - application/json

Schema for Permits in details response.

items
object[]
required

The list of items returned in the response following given criteria.

next_page
integer | null
required

The next page number of the response.

page
integer
required

The page number of the response.

size
integer
required

The number of items returned in the response.