Requests

A request is a request to place an order. The platform verifies your input and, when all fields are filled in correctly, an order is generated immediately.

Request definition

• laneId — fetched from the Lane API
• groupId and userId — fetched from the User API
• Desired pickup and delivery date times, in the timezone of the address
• References and comments for the pickup / delivery location and for the shipper
• tailLift — whether the order needs a tail lift
• A minimum and maximum temperature, required when the lane uses a refrigerated (Reefer) trailer

curl -X POST https://api.ctrlchain.com/api/v1/Request/lane-booking \
  -H "apiKey: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "laneId": "5a1c9e7d-2b3f-4a6c-8d9e-0f1a2b3c4d5e",
    "groupId": "8c2e1b4a-9d3f-4c5e-a6b7-c8d9e0f1a2b3",
    "userId": "b9b0054f-000f-4e0d-a529-555f31821541",
    "tailLift": false,
    "desiredPickupDateTimes": {
      "earliest": "2026-08-04T06:00:00",
      "latest": "2026-08-04T10:00:00"
    }
  }'

With this version of the API it is only possible to create one booking at a time. For recurring orders, call the same endpoint several times with the applicable dates and times.