GET
/
contractors
Get Contractors By Id
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

A list of contractors.

Schema for paginated contractors details response.

items
ContractorsRead · object[]
required

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

page
integer
required

The page number of the response.

size
integer
required

The number of items returned in the response.

next_page
integer | null
required

The next page number of the response.

pagination_type
string
default:offset
Allowed value: "offset"