The /v4/loads/refresh/list/covered/ endpoint lets you retrieve the complete index of your covered BrokerCarrier load announcements, beginning on a specified start date.
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/loads/refresh/list/covered |
Required Parameters
| Name | Type | Value(s) |
|---|---|---|
| status | string |
One of: active, pending, dnu
|
| start_date | string |
Date formatted as YYYY-MM-DD |
Example Response
Request: https://api.brokercarrier.com/v4/loads/refresh/list/covered?start_date=2024-01-01
The example response below shows a list containing five load announcements. Your real API calls will return much larger responses than this.
[
{
"details": {
"load_number": "147134219-1052",
"dates": {
"pickup": "2024-01-19",
"delivery": "2024-01-22"
},
"equipment": [
"drop_deck",
"flatbed"
],
"rate": 0,
"covered_by": {
"dot_number": "4100367"
}
},
"lane": {
"distance": 316.77,
"duration": 299,
"stops": [
"DENISON, TX 75020",
"HOUSTON, TX 77023"
]
},
"posted": "2024-01-18 13:04:47.168462"
},
{
"details": {
"load_number": "147134219-1017",
"dates": {
"pickup": "2023-12-14",
"delivery": "2023-12-14"
},
"equipment": [
"flatbed"
],
"rate": 700,
"covered_by": {
"dot_number": "3153569"
}
},
"lane": {
"distance": 180.21,
"duration": 202,
"stops": [
"HOUSTON, TX 77029",
"JACKSONVILLE, TX 75766"
]
},
"posted": "2023-12-14 13:10:14.903068"
},
{
"details": {
"load_number": "147134219-1015",
"dates": {
"pickup": "2023-12-14",
"delivery": "2023-12-15"
},
"equipment": [
"drop_deck",
"flatbed"
],
"rate": 775,
"covered_by": {
"dot_number": "3793767"
}
},
"lane": {
"distance": 270.26,
"duration": 313,
"stops": [
"ALEXANDRIA, LA 71302",
"NORTH LITTLE ROCK, AR 72114"
]
},
"posted": "2023-12-13 12:48:36.934377"
},
{
"details": {
"load_number": "147134219-930",
"dates": {
"pickup": "2023-10-05",
"delivery": "2023-10-09"
},
"equipment": [
"flatbed"
],
"rate": 3150,
"covered_by": {
"dot_number": "3589852"
}
},
"lane": {
"distance": 950.92,
"duration": 861,
"stops": [
"NORFOLK, NE 68701",
"PLYMOUTH, UT 84330"
]
},
"posted": "2023-10-05 12:14:32.642457"
},
{
"details": {
"load_number": "147134219-926",
"dates": {
"pickup": "2023-10-04",
"delivery": "2023-10-04"
},
"equipment": [
"flatbed"
],
"rate": 800,
"covered_by": {
"dot_number": "2494930"
}
},
"lane": {
"distance": 170.16,
"duration": 271,
"stops": [
"PLEASANT GROVE, UT 84062",
"COKEVILLE, WY 83114"
]
},
"posted": "2023-10-04 14:13:33.624055"
}
]