Get a Load Notification List

The /v2/load/announcements/get/notification/list endpoint lets you get the list of carriers who were notified about a particular load announcement.

For TMS integrators, use this to display this information within your UI. This data would be useful for constructing self-updating coverage maps, as these lists are of carriers with recent relevance in addition to their locations.

This endpoint must be called from the server side to avoid compromising your secret API key. Do not use your secret key in client-side JavaScript.

HTTP request

Method
URL
GET

Required parameters

Name
Type
Value(s)
pk
string
Your public API key
sk
string
Your secret API key
load_num
string
The unique load number. This number may have been generated by the BrokerCarrier Dashboard or by your TMS, depending on which one you used to post the load announcement.

Return values

This endpoint returns an object with the fields carriers and status. The carriers field is an array containing containing 1-500 objects, each with the following keys and values.

Key
Type
Value
phone
string
The carrier's dispatch phone number.
email
string
The carrier's dispatch email.
business_name
string
The carrier's business name.
dot_num
string
The carrier's DOT number.
mc_num
string
The carrier's MC number.

Example response

{
    "carriers": [
        {
            "phone": "5558675309",
            "email": "dispatch@acmetrucking.com",
            "business_name": "Acme Trucking Inc",
            "dot_num": "0101010",
            "mc_num": "010101"
        },
        {
            "phone": "5558675310",
            "email": "dispatch@madeupnametrucking.com",
            "business_name": "Madeupname Trucking Inc",
            "dot_num": "0202020",
            "mc_num": "020202"
        },
        {
            "phone": "5558676311",
            "email": "dispatch@fictionalfreightllc.com",
            "business_name": "Fictional Freight LLC",
            "dot_num": "0303030",
            "mc_num": "030303"
        }

        ... plus up to 497 more ...

    ],
    "status": 200
}
        

Start your 30-day free trial of BrokerCarrier today

You'll be up and running in 10 minutes.