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
field | type | description |
source_dot | string | The DOT of the carrier being looked up currently. |
target_dot | string | The DOT of the matching company. This could be a carrier or a broker docket. |
reason | string | An explanation of the match criteria. |
data | number or string | The number of times equipment matched or the matching data (phone, email, address, etc). |
date | date time string | A date time string of when this data was last updated. |
Matching Companies Reason Field
Criteria | Explanation | Value |
Equipment | This carrier's equipment vins have been inspected under another company's docket. | "Shared Equipment" |
Address | This carrier's FMCSA registered address matches with another company's FMCSA registered address. | "Same Address" |
Building | This carrier's FMCSA registered address matches with another company's FMCSA registered address with a different unit. | "Same Building" |
Email Address | This carrier's FMCSA registered email address matches with another company's FMCSA registered email address. | "Same Email Address" |
Phone Number | This carrier's FMCSA registered phone number matches with another company's FMCSA registered phone number. | "Same Phone#" |
Contact Name | This 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"
}
]