GET
/
contractors
curl --request GET \
  --url https://api.shovels.ai/v2/contractors \
  --header 'X-API-Key: <api-key>'
{
  "example": {
    "items": [
      {
        "id": "e79c3393ad",
        "license": "961870",
        "name": "CA SUNRISE CONSTRUCTION SOLUTION INC.",
        "business_name": "CA SUNRISE CONSTRUCTION SOLUTION INC.",
        "business_type": "Corporation",
        "classification": "CFC",
        "license_issue_date": "2018-05-15",
        "license_exp_date": "2024-05-15",
        "license_act_date": "2018-05-15",
        "primary_phone": "(425) 507-4300",
        "primary_email": "atobar.casunrise@gmail.com",
        "phone": "(425) 270-9678,(425) 281-6152",
        "email": "atobar.casunrise@gmail.com,david@calsunrise.com",
        "dba": "SUNRISE SOLAR",
        "sic": "1731",
        "naics": "238210",
        "linkedin_url": "https://linkedin.com/company/ca-sunrise-constr",
        "revenue": "$1M-$5M",
        "employee_count": "10-49",
        "primary_industry": "Solar Installation",
        "review_count": 42,
        "rating": 4.8,
        "status_tally": {
          "final": 754,
          "active": 81,
          "unknown": 2,
          "inactive": 313
        },
        "tag_tally": {
          "hvac": 27,
          "solar": 39,
          "reroof": 1,
          "pool_spa": 1,
          "heat_pump": 267,
          "utilities": 1110,
          "commercial": 20
        },
        "permit_count": 1150,
        "avg_job_value": 1500000,
        "total_job_value": 172500000,
        "avg_construction_duration": 45,
        "avg_inspection_pass_rate": 85,
        "address": {
          "street_no": "2800",
          "street": "COTTONWOOD DR",
          "city": "SAN BRUNO",
          "zip_code": "94066",
          "state": "CA",
          "address_id": "asd8a8b19",
          "latlng": [
            37.37619,
            -121.869064
          ]
        }
      }
    ],
    "size": 1,
    "pagination_type": "cursor"
  }
}

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
id
string[]
required

Filter by the contractor ID.

Maximum length: 50
​
cursor
string | null

Cursor for pagination

​
page
integer | null

Page number for offset-based pagination (only used if cursor is not provided)

Required range: x >= 1
​
size
integer
default:50

Number of items per page

Required range: 1 <= x <= 100

Response

200
application/json

A list of contractors.

Schema for paginated contractors details response.