API V4 – View Your Broker-Generated Lanes

The /v4/lanes/load/from/broker/ endpoint lets you retrieve the index of lanes on which you have posted load announcements through BrokerCarrier.

Notes on this endpoint:

  1. Potential for large responses. This endpoint can potentially return very large responses. For this reason, we recommend handling requests to this endpoint asynchronously.
  2. 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/lanes/load/from/broker

Required Parameters

None.

Example Response

Request: https://api.brokercarrier.com/v4/lanes/load/from/broker

The example response below shows a list containing five lanes with two load announcments on each. Your real API calls will return much larger responses than this.

[
    {
        "distance": 942.22,
        "duration": 961.46,
        "loads_announced": 13,
        "loads_summary": [
            {
                "load_number": "147134219-109",
                "contact": "Kyle Provost",
                "posted": "2022-08-05",
                "type": "full",
                "rate": 4000,
                "commodity": "Lumber"
            },
            {
                "load_number": "147134219-237",
                "contact": "Kyle Provost",
                "posted": "2022-10-01",
                "type": "full",
                "rate": 3100,
                "commodity": "Lumber that needs 8' tarps"
            }
        ],
        "stops": [
            "AKRON, IN 46910",
            "NEWBURYPORT, MA 01950"
        ]
    },
    {
        "distance": 2026.52,
        "duration": 1842.85,
        "loads_announced": 8,
        "loads_summary": [
            {
                "load_number": "147134219-284",
                "contact": "Kyle Provost",
                "posted": "2022-10-18",
                "type": "full",
                "rate": 5100,
                "commodity": "Lumber needing 8' tarps"
            },
            {
                "load_number": "147134219-343",
                "contact": "Kyle Provost",
                "posted": "2022-11-28",
                "type": "full",
                "rate": 5300,
                "commodity": "lumber"
            }
        ],
        "stops": [
            "AKRON, IN 46910",
            "SPARKS, NV 89431"
        ]
    },
    {
        "distance": 984.89,
        "duration": 899.57,
        "loads_announced": 7,
        "loads_summary": [
            {
                "load_number": "147134219-716",
                "contact": "Kyle Provost",
                "posted": "2023-06-19",
                "type": "full",
                "rate": 1400,
                "commodity": "RAILROAD CROSS TIES"
            },
            {
                "load_number": "147134219-735",
                "contact": "Kyle Provost",
                "posted": "2023-07-07",
                "type": "full",
                "rate": 1400,
                "commodity": null
            }
        ],
        "stops": [
            "TUCSON, AZ 85713",
            "HEARNE, TX 77859"
        ]
    },
    {
        "distance": 412.89,
        "duration": 411.31,
        "loads_announced": 7,
        "loads_summary": [
            {
                "load_number": "147134219-468",
                "contact": "Kyle Provost",
                "posted": "2023-03-16",
                "type": "full",
                "rate": 1200,
                "commodity": "steel bars"
            },
            {
                "load_number": "147134219-470",
                "contact": "Kyle Provost",
                "posted": "2023-03-21",
                "type": "full",
                "rate": 1200,
                "commodity": null
            }
        ],
        "stops": [
            "BLYTHEVILLE, AR 72315",
            "KNOXVILLE, TN 37914"
        ]
    },
    {
        "distance": 304.34,
        "duration": 287.19,
        "loads_announced": 6,
        "loads_summary": [
            {
                "load_number": "147134219-150",
                "contact": "Kyle Provost",
                "posted": "2022-08-16",
                "type": "full",
                "rate": null,
                "commodity": null
            },
            {
                "load_number": "147134219-655",
                "contact": "Kyle Provost",
                "posted": "2023-05-24",
                "type": "full",
                "rate": 625,
                "commodity": "PALLETIZED RAILROAD SPIKES"
            }
        ],
        "stops": [
            "SAND SPRINGS, OK 74063",
            "FORT WORTH, TX 76107"
        ]
    }
]