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
Response body containing the resultThe carrier object
Unique identifier for the carrier in the system
Legal name of the carrier
Current status of the carrier.
active - Carrier is active and approvedfail - Carrier failed verificationinactive - Carrier is inactivein_review - Carrier is under reviewnot_set - Status has not been set
Department of Transportation (DOT) number
Motor Carrier (MC) number
List of contacts for this carrier
Contact type. Must be one of: - primary - dispatch - billing - driver - claims
Preferred contact method. Must be one of: - email - phone - text
Integration status information
Integration processing status
success - Carrier was successfully processed and integratedfailed - Carrier processing failed
The ID assigned to this carrier in the bridge system (when status is success)
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'
{
"statusCode": 200,
"body": {
"carrier": {
"carrier_id": "CAR123456",
"carrier_name": "ABC Trucking Inc.",
"status": "active",
"dot_number": "987654",
"mc_number": "123456",
"contacts": [
{
"name": "John Dispatcher",
"email": "dispatch@abctrucking.com",
"phone": "5551234567",
"type": "dispatch",
"extension": "101",
"preferred_contact_method": "phone"
}
],
"bridge": {
"status": "success",
"bridge_carrier_id": "BRK-CAR-789"
}
}
}
}
