The /v4/search/ein/ endpoint lets you load the list of carriers that have been associated with any particular EIN.
The key distinction between this endpoint and /v4/search/dot/ is that this endpoint returns a list of carriers, not an in-depth profile, even if only one carrier matches to the EIN.
Notes on this endpoint:
- 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/search/ein |
Required Parameters
| Name | Type | Value(s) |
|---|---|---|
| ein | string |
Any 9-digit EIN, with or without dashes. Examples: 123456789 or 12-3456789
|
Example Response
Request: https://api.brokercarrier.com/v4/search/ein?ein=20-5350913
The example response shows the public overview data of a carrier whose on-file EIN was 20-5350913 in the previous five years.
[
{
"dot_number": "1556061",
"legal_name": "GENERAL TRUCKING INC",
"carrier_operation": "A",
"authority": [
{
"status": {
"broker": "n",
"common": "a",
"contract": "n"
},
"authorized": {
"hhg": "n",
"broker": "n",
"property": "y",
"passenger": "n"
},
"docket_number": 578193,
"docket_prefix": "MC"
}
],
"docket_numbers": [
{
"docket_number": 578193,
"docket_prefix": "MC"
}
],
"phy_address": "24121 MOUND RD WARREN, MI 48091",
"mailing_address": "24121 MOUND RD WARREN, MI 48091",
"email": "safety@generaltrucking.net",
"phone": "(866) 943-6878",
"active": "y",
"onboarded": {
"status": 0
}
}
]