API V4 – View Your Open Load Announcements

The /v4/loads/refresh/list/open/ endpoint lets you retrieve the complete index of your open BrokerCarrier load announcements, beginning on a specified start date.

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/refresh/list/open

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/open?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": "566DA315-1709063661",
            "dates": {
                "pickup": "02-24-2024",
                "delivery": "03-04-2024"
            },
            "equipment": [
                "drop_deck"
            ],
            "rate": 0
        },
        "lane": {
            "distance": 2615.96,
            "duration": 2520,
            "stops": [
                "SPARKS, NV 89436",
                "MAPLE LAKE, MN 55358",
                "MEMPHIS, TN 37501"
            ]
        },
        "posted": "2024-02-27 11:54:21.999133"
    },
    {
        "details": {
            "load_number": "566DA315-1709063639",
            "dates": {
                "pickup": "02-24-2024",
                "delivery": "03-04-2024"
            },
            "equipment": [
                "drop_deck"
            ],
            "rate": 0
        },
        "lane": {
            "distance": 2615.96,
            "duration": 2520,
            "stops": [
                "SPARKS, NV 89436",
                "MAPLE LAKE, MN 55358",
                "MEMPHIS, TN 37501"
            ]
        },
        "posted": "2024-02-27 11:53:59.339697"
    },
    {
        "details": {
            "load_number": "566DA315-1709063615",
            "dates": {
                "pickup": "02-24-2024",
                "delivery": "03-04-2024"
            },
            "equipment": [
                "drop_deck"
            ],
            "rate": 0
        },
        "lane": {
            "distance": 2615.96,
            "duration": 2520,
            "stops": [
                "SPARKS, NV 89436",
                "MAPLE LAKE, MN 55358",
                "MEMPHIS, TN 37501"
            ]
        },
        "posted": "2024-02-27 11:53:35.328736"
    },
    {
        "details": {
            "load_number": "566DA315-1709063501",
            "dates": {
                "pickup": "02-24-2024",
                "delivery": "03-04-2024"
            },
            "equipment": [
                "drop_deck"
            ],
            "rate": 0
        },
        "lane": {
            "distance": 2615.96,
            "duration": 2520,
            "stops": [
                "SPARKS, NV 89436",
                "MAPLE LAKE, MN 55358",
                "MEMPHIS, TN 37501"
            ]
        },
        "posted": "2024-02-27 11:51:41.976662"
    },
    {
        "details": {
            "load_number": "566DA315-1709063448",
            "dates": {
                "pickup": "03-02-2024",
                "delivery": "03-04-2024"
            },
            "equipment": [
                "dry_van"
            ],
            "rate": 0
        },
        "lane": {
            "distance": 193.09,
            "duration": 206,
            "stops": [
                "JASPER, AL 35501",
                "ACWORTH, GA 30102"
            ]
        },
        "posted": "2024-02-27 11:50:48.7518"
    }
]