Contractors
Addresses
Counties
Jurisdictions
Zipcodes
States
Get Contractors By Id
Returns contractors by their IDs. Multiple id query parameters can be provided in the same API call
curl --request GET \
--url https://api.shovels.ai/v2/contractors \
--header 'X-API-Key: <api-key>'{
"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://www.linkedin.com/company/ca-sunrise-construction",
"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
]
}
}
],
"page": 1,
"size": 1
}Authorizations
Query Parameters
Filter by the contractor ID.
x >= 11 <= x <= 100Response
The list of items returned in the response following given criteria.
The contractor ID.
The contractor's address dictionary.
The number of the street of the contractor's address.
The name of the street of the contractor's address.
The city of the contractor's address.
The jurisdiction contractor's address belongs to.
The ZIP code of the contractor's address.
The extension of the ZIP code of the contractor's address.
The state of the contractor's address.
The permit's address identifier.
The latitude and longitude of the address.
The contractor license number.
The contractor name.
The contractor business name.
The number of the street of the contractor's address.
The name of the street of the contractor's address.
The city of the contractor's address.
The jurisdiction contractor's address belongs to.
The ZIP code of the contractor's address.
The extension of the ZIP code of the contractor's address.
The state of the contractor's address.
The latitude and longitude of the contractor's address.
The type of business: JointVenture, Corporation, Partnership, Limited Liability, Sole Owner.
The contractor's classification/certification.
The license issue date.
The license expiration date.
Date when the contractor's license became inactive.
Date when the contractor's license became active.
The contractor's primary phone number.
The contractor's primary email.
The contractor's phone number(s).
The contractor's email(s).
The contractor's website).
Doing Business As name for the contractor.
Standard Industrial Classification (SIC) code of the contractor.
North American Industry Classification System (NAICS) code of the contractor.
LinkedIn URL of the contractor.
Annual revenue of the contractor's business.
Number of employees working for the contractor.
Primary industry in which the contractor operates.
Number of reviews the contractor has received.
Rating of the contractor based on reviews.
The summary of all status counts for contractors' work. Available statuses: active, final, unknown, inactive, in_review.
The summary of all tag counts for contractors' work.
The total number of permits.
The average job value of all permits in cents (integer value representing dollars × 100).
The total job value of all permits in cents (integer value representing dollars × 100).
The average construction duration in days.
The average inspection pass rate as a percentage (0-100).
The page number of the response.
The number of items returned in the response.
The next page number of the response.
Was this page helpful?
curl --request GET \
--url https://api.shovels.ai/v2/contractors \
--header 'X-API-Key: <api-key>'{
"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://www.linkedin.com/company/ca-sunrise-construction",
"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
]
}
}
],
"page": 1,
"size": 1
}