CtrlChain Developers
POST /api/v1/Request/lane-booking

Request a lane booking

Places a booking on a lane. The platform validates your input and, when all fields are correct, immediately generates an order. Bookings are created one at a time — for recurring orders, call this endpoint once per shipment.

Body parameters

laneId string (uuid)required
Id of the lane to create the booking for
groupId string (uuid)required
Id of the group to create the booking with. This can be a subgroup
userId string (uuid)required
Id of a user with the Booker role, that will be associated with the booking
desiredPickupDateTimes object
Object containing the desired pickup times The provided times are expected to be in the timezone of the pickup address
desiredDeliveryDateTimes object
Object containing the desired delivery times The provided times are expected to be in the timezone of the delivery address
tailLift booleanrequired
Indicate if you need a tail lift on your booking/order
comments object
Object containing all comments
references object
Object containing all references
temperature object
Object containing optional temperature data This is required when you place a booking with a refrigerated trailer type

Returns

The reference numbers of the created request and order, plus the resolved pickup and delivery addresses and dates. Invalid input fails with 400 and a problem details body.