Skip to main content

matchingCompanies

Matching Companies Data

When requesting a Carrier Profile, the matching_companies field will contain a list of matching companies objects that match certain aspects of the carrier being looked up. This field may be an empty list if none of the criteria is met.

Matching Companies Object

fieldtypedescription
source_dotstringThe DOT of the carrier being looked up currently.
target_dotstringThe DOT of the matching company. This could be a carrier or a broker docket.
reasonstringAn explanation of the match criteria.
datanumber or stringThe number of times equipment matched or the matching data (phone, email, address, etc).
datedate time stringA date time string of when this data was last updated.

Matching Companies Reason Field

CriteriaExplanationValue
EquipmentThis carrier's equipment vins have been inspected under another company's docket."Shared Equipment"
AddressThis carrier's FMCSA registered address matches with another company's FMCSA registered address."Same Address"
BuildingThis carrier's FMCSA registered address matches with another company's FMCSA registered address with a different unit."Same Building"
Email AddressThis carrier's FMCSA registered email address matches with another company's FMCSA registered email address."Same Email Address"
Phone NumberThis carrier's FMCSA registered phone number matches with another company's FMCSA registered phone number."Same Phone#"
Contact NameThis carrier's FMCSA registered point of contact matches with another company's FMCSA registered point of contact."Same Contact Name"

Example matching_companies data

Here is an example of what type of information might be contained in the matching_companies list:

[
{
"source_dot": "1234567",
"target_dot": "7654321",
"reason": "Same Phone#",
"data": "1234567890", // The phone number that was matched
"date": "2023-06-05T07:10:01.285Z"
},
{
"source_dot": "554433",
"target_dot": "228855",
"reason": "Shared Equipment",
"data": 1, // # of instances of shared equipment
"date": "2023-06-05T07:10:01.285Z"
},
{
"source_dot": "114477",
"target_dot": "336933",
"reason": "Same Address",
"data": "123 ANYWHERE STREET ROSWELL, NM 42069", // The address that was matched
"date": "2023-06-05T07:10:01.285Z"
}
]