Deals

Search contractors by permit activity

Returns contractor profiles aggregated from 45M+ building permits. Each profile includes permit count, jurisdictions worked, total declared permit value, and activity dates. Use to identify active contractors in a market or find a specific contractor by name.

get/api/v1/deals/contractors

Request

  • Base URL: https://propraven.com
  • URL: https://propraven.com/api/v1/deals/contractors
  • Auth: HTTP bearer

Query parameters

searchstring
Example:SMITH CONSTRUCTION

Contractor name search (case-insensitive substring).

min_permitsinteger

Minimum permit count to include.

statestring
Example:NC

2-letter state filter.

min_valueinteger

Minimum total declared permit value, USD.

limitinteger

Page size, max 500.

offsetinteger

Pagination offset.

Response

Contractor profiles returned.

totalinteger required
limitinteger required
offsetinteger required
field_notesobject

What each re-derived contractor field means (#558).

Example response

{
  "data": [
    {
      "contractor_name_normalized": "ABC CONSTRUCTION LLC",
      "permit_count": 1240,
      "jurisdiction_count": 12,
      "state_count": 3,
      "county_count": 8,
      "total_permit_value": 184500000,
      "avg_permit_value": 148790
    }
  ]
}

Changes

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