The /v4/search/phone/ endpoint lets you load the list of carriers whose email address matches your search.
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 search phrase.
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/phone |
Required Parameters
| Name | Type | Value(s) |
|---|---|---|
| phone | string |
The full phone number to match. Must be properly formatted. Example: 5558675309 or (555) 867-5309
|
Example Response
Request: https://api.brokercarrier.com/v4/search/phone?phone=(555)%20867-5309
The example response shows the public overview data of carriers whose phone number has been "(555) 867-5309" in the previous five years.
[
{
"dot_number": "4043310",
"legal_name": "HI DIDDLY HO HAULING LLC",
"carrier_operation": "C",
"authority": null,
"docket_numbers": null,
"phy_address": "3586 BRICKLER RD SPRINGFIELD, IL 62707-3517",
"mailing_address": "3586 BRICKLER RD SPRINGFIELD, IL 62707-3517",
"email": "rodandtodd@yahoo.com",
"phone": "(555) 867-5309",
"active": "y",
"onboarded": {
"status": 0
}
},
{
"dot_number": "4153490",
"legal_name": "ALPINE HAULING LLC",
"carrier_operation": "C",
"authority": null,
"docket_numbers": null,
"phy_address": "45 S MAIN ST SODA SPRINGS, ID 83276",
"mailing_address": "45 S MAIN ST SODA SPRINGS, ID 83276",
"email": "j.alpine@gmail.com",
"phone": "(555) 867-5309",
"active": "y",
"onboarded": {
"status": 0
}
}
]