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"
  }
]