The /v4/search/address/ endpoint lets you load the list of carriers whose mailing or physical addresses could be related to your search phrase.
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/address |
Required Parameters
| Name | Type | Value(s) |
|---|---|---|
| address | string |
The full or partial address to match |
Example Response
Request: https://api.brokercarrier.com/v4/search/address?address=500%20first%20street
The example response shows the public overview data of carriers whose mailing or physical addresses matched the phrase "500 first street" in the previous five years.
{
"physical_address": [
{
"dot_number": "787527",
"legal_name": "NOLTE REPAIR",
"carrier_operation": "C",
"phy_address": "500 SOUTH FIRST STREET SPRINGFIELD, NE 68059",
"mailing_address": "16701 SOUTH 138TH STREET SPRINGFIELD, NE 68059",
"email": null,
"phone": "(402) 253-8369",
"active": "y",
"onboarded": {
"status": 0
}
},
{
"dot_number": "1480623",
"legal_name": "DREAM FLIGHT USA FOUNDATION INC",
"carrier_operation": "C",
"phy_address": "500 FIRST STREET SUITE 2300 WAUSAU, WI 54403",
"mailing_address": "500 FIRST STREET SUITE 2300 WAUSAU, WI 54403",
"email": "bkgrueneberg@progressivetravel.org",
"phone": "(715) 845-6392",
"active": "y",
"onboarded": {
"status": 0
}
},
{
"dot_number": "1862594",
"legal_name": "CURTIS D RYEN",
"carrier_operation": "C",
"phy_address": "500 WEST FIRST STREET TAYLORVILLE, IL 62568",
"mailing_address": "500 WEST FIRST STREET TAYLORVILLE, IL 62568",
"email": "curtisryen@pioneerhomeinspections.com",
"phone": "(217) 820-0481",
"active": "y",
"onboarded": {
"status": 0
}
},
{
"dot_number": "1930806",
"legal_name": "MATMACO LLC",
"carrier_operation": "C",
"phy_address": "500 NORTH FIRST STREET WARNER ROBINS, GA 31093",
"mailing_address": "104 PINE BLUFF DRIVE WARNER ROBINS, GA 31088",
"email": "x1boss@aol.com",
"phone": "(478) 922-0021",
"active": "y",
"onboarded": {
"status": 0
}
},
{
"dot_number": "2851685",
"legal_name": "SAUNDERS AIR CONDITIONING & HEATING",
"carrier_operation": "C",
"phy_address": "500 N FIRST STREET TURLOCK, CA 95380",
"mailing_address": "500 N FIRST STREET TURLOCK, CA 95380",
"email": null,
"phone": "(209) 634-9313",
"active": "y",
"onboarded": {
"status": 0,
"ca_id": 0
}
}
],
"mailing_address": [
{
"dot_number": "1480623",
"legal_name": "DREAM FLIGHT USA FOUNDATION INC",
"carrier_operation": "C",
"phy_address": "500 FIRST STREET SUITE 2300 WAUSAU, WI 54403",
"mailing_address": "500 FIRST STREET SUITE 2300 WAUSAU, WI 54403",
"email": "bkgrueneberg@progressivetravel.org",
"phone": "(715) 845-6392",
"active": "y",
"onboarded": {
"status": 0
}
},
{
"dot_number": "1862594",
"legal_name": "CURTIS D RYEN",
"carrier_operation": "C",
"phy_address": "500 WEST FIRST STREET TAYLORVILLE, IL 62568",
"mailing_address": "500 WEST FIRST STREET TAYLORVILLE, IL 62568",
"email": "curtisryen@pioneerhomeinspections.com",
"phone": "(217) 820-0481",
"active": "y",
"onboarded": {
"status": 0
}
},
{
"dot_number": "2851685",
"legal_name": "SAUNDERS AIR CONDITIONING & HEATING",
"carrier_operation": "C",
"phy_address": "500 N FIRST STREET TURLOCK, CA 95380",
"mailing_address": "500 N FIRST STREET TURLOCK, CA 95380",
"email": null,
"phone": "(209) 634-9313",
"active": "y",
"onboarded": {
"status": 0
}
}
]
}