curl --request GET \
--url 'https://api.example.com/api/v1/carriers/find?mc=123456' \
--header 'Authorization: Bearer API_KEY'
{
"status": 200,
"carrier": {
"carrier_id": "CAR123456",
"carrier_name": "ABC Trucking Inc.",
"status": "Active",
"dot_number": "987654",
"mc_number": "123456"
}
}
Locate a carrier in the system using either their MC number or DOT number.
Query Parameters
The Motor Carrier (MC) number of the carrier. Either mc or dot must be provided.
The Department of Transportation (DOT) number of the carrier. Either mc or dot must be provided.
Response
The carrier object
Unique identifier for the carrier in the system
Legal name of the carrier
Current status of the carrier. We suggest these values but you can use your own.
ACTIVE - Carrier is active and approvedFAIL - Carrier failed verificationINITIATED - Carrier onboarding has been initiatedIN REVIEW - Carrier is under reviewNOT SET - Status has not been setPENDING - Carrier is pending approvalSUSPENDED - Carrier has been suspendedINACTIVE - Carrier is inactiveSIGNED UP - Carrier has completed sign upUNREGISTERED - Carrier is not registered
Department of Transportation (DOT) number
Motor Carrier (MC) number
Status Codes
Successfully found the carrier
Bad request - Missing required parameters
Carrier not found with the specified identifiers
curl --request GET \
--url 'https://api.example.com/api/v1/carriers/find?mc=123456' \
--header 'Authorization: Bearer API_KEY'
{
"status": 200,
"carrier": {
"carrier_id": "CAR123456",
"carrier_name": "ABC Trucking Inc.",
"status": "Active",
"dot_number": "987654",
"mc_number": "123456"
}
}
