Truck Booking API Example | Cargoboard API

A booking for a complete 7.5 t truck (DIRECT_TRUCK_7_5) with the DIRECT product, loaded and unloaded at a ramp. All vehicle types are listed on Van/Truck Product.

🧪
Try it in the sandbox
This example uses the sandbox (https://api-sandbox.cargoboard.com), so no real transport is triggered. Use an upcoming pickup date.

Request

curl --request POST \
     --url https://api-sandbox.cargoboard.com/v1/orders \
     --header 'Content-Type: application/json' \
     --header 'X-API-KEY: YourKeyHere' \
     --data '
{
    "product": "DIRECT",
    "shipper": {
        "name": "Producer ABC GmbH & Co. KG",
        "address": {
            "street": "Examplestreet 12a",
            "countryCode": "DE",
            "postCode": "58553",
            "city": "Halver"
        },
        "pickupOn": "2026-12-01",
        "loadingType": "RAMP",
        "wantsTailLiftTruck": false
    },
    "consignee": {
        "name": "Consignee ABC AG",
        "address": {
            "street": "Examplestreet 5",
            "countryCode": "DE",
            "postCode": "85137",
            "city": "Walting"
        },
        "unloadingType": "RAMP",
        "wantsTailLiftTruck": false
    },
    "lines": [
        {
            "unitQuantity": 1,
            "unitPackageType": "DIRECT_TRUCK_7_5",
            "unitLength": 610,
            "unitWidth": 240,
            "unitHeight": 240,
            "unitWeight": 2500,
            "content": "Machinery",
            "isStackable": false
        }
    ]
}
'

What's specific to vehicle bookings

Field	Value	Meaning
`product`	`DIRECT`	Direct transport without reloading
`lines[].unitPackageType`	`DIRECT_TRUCK_7_5`	Truck 7.5 t, up to 2,500 kg
`shipper.loadingType`, `consignee.unloadingType`	`RAMP`	Loaded and unloaded at a ramp — see loading types

The response has the same structure as in Booking with minimum details.