Here is an example for a booking call for a national shipment, with the minimum request parameters:
curl --request POST \
--url https://api.cargoboard.com/v1/orders \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: YOUR KEY HERE' \
--data '
{
"product": "STANDARD",
"shipper": {
"name": "Mustermann GmbH",
"address": {
"street": "Ostrstr. 24",
"countryCode": "DE",
"postCode": "58553",
"city": "Halver"
},
"pickupOn": "2024-12-11"
},
"consignee": {
"name": "Fabian Müller",
"address": {
"street": "Hofstetterstr.4 ",
"countryCode": "DE",
"postCode": "85137",
"city": "Walting"
}
},
"lines": [
{
"unitQuantity": 1,
"unitPackageType": "FP",
"unitLength": 120,
"unitWidth": 80,
"unitHeight": 120,
"unitWeight": 200,
"content": "Werkzeugmaschine"
}
]
}
'
Response:
{
"data": {
"id": "cm3328igs04jbqt0dluurnxyl",
"reference": "10374504", //this is our main shipment number and this is used for customer communication
"costItems": [
{
"description": "Frachtkosten",
"type": "SHIPMENT",
"subtype": null,
"price": {
"amount": 94.23,
"currency": "EUR"
},
"pricePartVat": {
"amount": 17.9,
"percentage": 19,
"currency": "EUR"
}
},
{
"description": "Klimaschutzbeitrag",
"type": "CLIMATE_COMPENSATION_SURCHARGE",
"subtype": null,
"price": {
"amount": 0.7,
"currency": "EUR"
},
"pricePartVat": {
"amount": 0.13,
"percentage": 19,
"currency": "EUR"
}
}
],
"pickupOn": "2024-12-11T07:00:00.000Z",
"pickupAtFrom": "2024-12-11T07:00:00.000Z",
"pickupAtUntil": "2024-12-11T15:00:00.000Z",
"price": {
"amount": 94.93,
"currency": "EUR",
"grossAmount": 112.97,
"vatAmount": 18.04
},
"priceStandard": {
"amount": 94.93,
"currency": "EUR"
},
"runtime": {
"daysMin": 1,
"daysMax": 2
},
"delivery": {
"earliest": "2024-12-12T07:00:00.000Z",
"latest": "2024-12-13T15:00:00.000Z"
},
"product": "STANDARD",
"transportType": "GROUPAGE",
"co2Emission": {
"amount": 0.7,
"value": 35.58,
"unit": "KG"
}
},
"links": [
{
"rel": "self",
"method": "POST",
"description": "Place an order.",
"href": "https://api.staging.cargoboard.com/v1/orders"
},
{
"rel": "self",
"method": "GET",
"description": "Orders.",
"href": "https://api.staging.cargoboard.com/v1/orders"
},
{
"rel": "self",
"method": "GET",
"description": "Order.",
"href": "https://api.staging.cargoboard.com/v1/orders/cm3328igs04jbqt0dluurnxyl"
},
{
"rel": "orderCancel",
"method": "POST",
"description": "Cancel an order.",
"href": "https://api.staging.cargoboard.com/v1/orders/cm3328igs04jbqt0dluurnxyl/cancel"
},
{
"rel": "orderPrintConfirmation",
"method": "GET",
"description": "Print confirmation for an order.",
"href": "https://api.staging.cargoboard.com/v1/orders/cm3328igs04jbqt0dluurnxyl/print-confirmation"
},
{
"rel": "orderPrintShipmentLabels",
"method": "GET",
"description": "Print shipment labels for an order.",
"href": "https://api.staging.cargoboard.com/v1/orders/cm3328igs04jbqt0dluurnxyl/print-shipment-labels"
},
{
"rel": "orderTrack",
"method": "GET",
"description": "Track an order.",
"href": "https://api.staging.cargoboard.com/v1/orders/10374504/tracking"
}
]
}