Search Contractors

Cursor for pagination

When true and on the first page (no cursor), include total_count in the response. The count is exact up to 10,000; above that, relation is 'gte'.

Include tag and status tallies in response. Set to false to omit tally computation for faster response times when tallies are not needed.

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

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

Substring to search for in permit description (case-insensitive). Matches anywhere in the text, including partial words.

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

Filter by the minimum permit approval duration in days.

Filter by the minimum project construction duration in days.

Filter by the minimum inspection pass rate.

Filter by the minimum job value.

Filter by minimum permit fees.

Filter by one or more tags. Use '-' prefix to exclude tags. Example: ?permit_tags=solar&permit_tags=-roofing (has solar, not roofing).

Filter results by geographic area. Accepts:

• US state code (e.g. CA)
• ZIP code (e.g. 90210 or 90210-1234)
• Shovels geolocation ID for an address, city, county, or jurisdiction (e.g. a4xysKbZwqg)

Resolve addresses and places to geolocation IDs via:

• Search Addresses
• Search Cities
• Search Counties
• Search Jurisdictions

Free-form text such as "123 Main St" is not accepted.

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

Minimum assessed market value of the property.

Minimum total building area in sq ft.

Minimum size of the property lot in sq ft.

Minimum number of property stories.

Minimum number of property units

Filter by derived contractor classifications. Use '-' prefix to exclude. Example: ?classification_derived=electrical&classification_derived=-hvac. Returns results containing ALL specified classifications. Possible values: concrete_and_paving, demolition_and_excavation, electrical, fencing_and_glazing, framing_and_carpentry, general_building_contractor, general_engineering_contractor, hvac, landscaping_and_outdoor_work, other, plumbing, roofing, specialty_trades.

Filter by contractor's name or business name (partial match supported). Must be at least 3 characters — shorter patterns cannot use the trigram index and would force a sequential scan.

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

Minimum lifetime job value of the contractor.

Minimum lifetime permits count.

Minimum lifetime inspection pass rate. The value must be an integer between 0 and 100, inclusive.

Filter by the contractor's license