API V4 – Load Announcement Details

The /v4/loads/load/details/ endpoint lets you retrieve the complete details of a BrokerCarrier load announcement, including the list of carriers that were notified.

Notes on this endpoint:

  1. 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/load/details

Required Parameters

Name Type Value(s)
load_number string The unique generated load announcement number

Example Response

Request: https://api.brokercarrier.test/v4/loads/load/details?load_number=566DA315-1709063661

The example below shows 5 carriers in the notified list for brevity purposes. Your real load announcements will notify 50, 100, or 200 carriers each. Also, the lane->polylines field will be significantly longer than the truncated string in this example.

{
    "cargo": {
        "weight": null,
        "length": null,
        "width": null,
        "height": null,
        "commodity": null
    },
    "carriers": [
        {
            "business_name": "10 ROADS EXPRESS LLC",
            "phone": "8663489290",
            "email": "sales@10roadsexpress.com",
            "dot_number": "3345061",
            "mc_number": "1068369"
        },
        {
            "business_name": "4 D TRUCKING LLC",
            "phone": "4053678444",
            "email": "dispatch@3ddispatch.com",
            "dot_number": "2102250",
            "mc_number": "768354"
        },
        {
            "business_name": "624889 BC LTD",
            "phone": "4033453558",
            "email": "dispatch@evanstrucking.ca",
            "dot_number": "770847",
            "mc_number": "345953"
        },
        {
            "business_name": "AAGUILA TRANSPORT INC",
            "phone": "4073086528",
            "email": "aaguilatransport@gmail.com",
            "dot_number": "3647843",
            "mc_number": "1425969"
        },
        {
            "business_name": "ABK LOGISTICS CO",
            "phone": "5733567837",
            "email": "abklogisticsco@gmail.com",
            "dot_number": "3576186",
            "mc_number": "1206344"
        }
    ],
    "contact": {
        "name": "Kyle Provost",
        "email": "kyle@brokercarrier.com",
        "phone": "(775) 224-0448",
        "phone_ext": null
    },
    "coverage": {
        "covered": false,
        "dot_number": null
    },
    "details": {
        "load_number": "566DA315-1709063661",
        "type": "Full",
        "rate": null,
        "notes": null
    },
    "equipment": [
        "Drop-Deck/Step-Deck"
    ],
    "lane": {
        "distance": 2615.96,
        "duration": 2520,
        "polylines": [
            "atwqjAx{kicFJtsC_SI_KFiK\\m[fB`A`_@FfKIdK[fKg@|Iu@|IcAvIoArI}AlIgBfIkBdHuB~G_CvGkq@rhBcBpE~C|BbLjIxKtI~DfDhAv@|B`BpFdDvFtC|..."
        ]
    },
    "services": [
        "Satellite/GPS",
        "Expedited"
    ],
    "stops": [
        {
            "type": "pickup",
            "latest_date": "02/24/2024",
            "earliest_date": "02/24/2024",
            "place": "SPARKS, NV 89436",
            "lat": "39.6269",
            "lng": "-119.7081"
        },
        {
            "type": "both",
            "latest_date": "03/02/2024",
            "earliest_date": "03/02/2024",
            "place": "MAPLE LAKE, MN 55358",
            "lat": "45.2202",
            "lng": "-93.9638"
        },
        {
            "type": "drop",
            "latest_date": "03/04/2024",
            "earliest_date": "03/04/2024",
            "place": "MEMPHIS, TN 37501",
            "lat": "35.1693",
            "lng": "-89.9904"
        }
    ]
}