The /v4/carriers/load/vetting/report endpoint lets you retrieve a full vetting report for a carrier that you have onboarded into your network.
Notes on this endpoint:
- Potential for large responses. This endpoint can potentially return very large responses. Carriers with many hidden connections to other carriers will return large tables of contact data. For this reason, we recommend handling requests to this endpoint asynchronously.
- Authentication via header. To authenticate your API call, pass in your public API key with the X-Api-Key HTTP header.
HTTP Request
| Method | URL |
|---|---|
| GET | https://api.brokercarrier.com/v4/carriers/load/vetting/report |
Required Parameters
| Name | Type | Value(s) |
|---|---|---|
| id_type | string |
One of: dot, mc
|
| id_number | string |
The carrier's DOT number or MC number |
Example Response
Request: https://api.brokercarrier.com/v4/carriers/load/vetting/report?id_type=dot&id_number=3408772
The example response below shows a carrier with relatively few items. Your real API calls may return much larger responses.
{
"hidden_connections": {
"email": [
],
"license_plates": {
"license_plates": {
"total": 0,
"list": [
]
},
"inspections": {
"total": 0,
"list": [
]
}
},
"mailing_address": [
{
"dot_number": "4047341",
"mailing_address": "1311 PROSPECT VILLAGE LN APT C BALLWIN, MO 63021-5767",
"dot_active": "y",
"legal_name": "RST EXPRESS LLC",
"phy_address": "1311 PROSPECT VILLAGE LN APT C BALLWIN, MO 63021",
"email": "rstexpress.stl@gmail.com",
"phone": "(929) 383-4211"
}
],
"phone": [
],
"phy_address": [
{
"dot_number": "4047341",
"phy_address": "1311 PROSPECT VILLAGE LN APT C BALLWIN, MO 63021",
"dot_active": "y",
"legal_name": "RST EXPRESS LLC",
"mailing_address": "1311 PROSPECT VILLAGE LN APT C BALLWIN, MO 63021-5767",
"email": "rstexpress.stl@gmail.com",
"phone": "(929) 383-4211"
}
],
"vins": {
"vins": {
"total": 0,
"list": [
]
},
"inspections": {
"total": 0,
"list": [
]
}
}
},
"onboarding_items": [
{
"category": "Back Office",
"code": "ob_session_country",
"description": "Onboarding conducted from foreign country.",
"details": "This carrier's business address is in FOX LAKE, IL, US, but the onboarding was conducted from Ukraine.
This is highly suspect and may indicate one or both of the following: 1) The carrier lacks a principal
place of business in accordance with Title 49 CFR 390.5; or 2) The onboarding was conducted by a
third-party agent from an overseas dispatching service.",
"points": 171
},
{
"category": "DOT Registration",
"code": "ob_phy_address_1",
"description": "Problematic physical address.",
"details": "There are 2 carriers that list this physical address with the DOT. This is suspect, but may have a
reasonable explanation. Please discuss with the carrier.",
"points": 119
},
{
"category": "DOT Registration",
"code": "ob_mailing_address_1",
"description": "Problematic mailing address.",
"details": "There are 2 carriers that use this mailing address. This is suspect, but may have a reasonable
explanation. Please discuss with the carrier.",
"points": 119
},
{
"category": "Dispatcher",
"code": "dispatcher_phone",
"description": "Suspect dispatcher contact information.",
"details": "Dispatcher's area code is different from what is on file with DOT. We suggest asking for an explanation
and a referral to the dispatch service, if applicable.",
"points": 30
},
{
"category": "Contact Information",
"code": "free_email",
"description": "Free email service or unbranded email address.",
"details": "This carrier is using a free email service rather than a branded domain name. This is undesirable but
probably has a reasonable explanation. Please discuss with carrier.",
"points": 20
}
],
"risk_score": {
"points": {
"total": 459,
"max": 1115
},
"score": 58.8
}
}