PULLFIRST[THE RECORD]
API ReferenceLicenses

Find contractors related by shared address or phone number

GET
/v1/licenses/{licenseNumber}/related

Helps identify contractors operating from the same location or using the same contact info. Useful for detecting contractors who may have had licenses revoked and reopened under a new name.

Authorization

Bearer
AuthorizationBearer <token>

API key passed as a Bearer token. Keys start with sk_live_.

In: header

Path Parameters

licenseNumber*string

The license number to find relationships for

Length0 <= length <= 50

Response Body

application/json

application/json

curl -X GET "https://loading/api/docs-proxy/v1/licenses/string/related"
[
  {
    "licenseNumber": "string",
    "name": "string",
    "dbaName": "string",
    "licenseType": "string",
    "status": "string",
    "city": "string",
    "state": "string",
    "hasEnforcementAction": true,
    "matchType": "string"
  }
]
Empty

/v1/licenses/{licenseNumber}/permits/locations GET

Previous Page

Get the full contractor aggregate for a license GET

Resolves the license to its parent contractor entity and returns every member license plus permits, enforcement, OSHA records, and Google Places for the whole group. Permits are deduplicated by permit id even when multiple member licenses matched them. Match records carry a tier field (VERIFIED / LIKELY / POSSIBLE / AMBIGUOUS); AMBIGUOUS rows cannot be uniquely attributed and must be handled explicitly by callers. When the license has no resolved contractor (edge case), only that single license is returned with `contractorId = null` and no aggregated data.