GET /api/v1/Lane/get-lanes

Get lanes

Returns your contracted lanes. Only lanes that are currently valid are included — if a lane is missing, contact your account manager.

Returns

A list of lane objects with their locations, vehicle and trailer type, contacts, and the agreed rates per validity period. Pass the laneId when requesting a booking.

Request

curl https://api.ctrlchain.com/api/v1/Lane/get-lanes \
  -H "apiKey: $CTRLCHAIN_API_KEY"

Response · 200 OK

{
  "lanes": [
    {
      "laneId": "5a1c9e7d-2b3f-4a6c-8d9e-0f1a2b3c4d5e",
      "laneReferenceNumber": "LANE-2026-0118",
      "pickupAddress": {
        "locationId": "1f7d2a3c-4b5e-4f6a-8b9c-0d1e2f3a4b5c",
        "locationName": "NewCold Wakefield",
        "street": "Barmoor Way",
        "number": "1",
        "city": "Wakefield",
        "zipCode": "WF10 5UB",
        "country": "United Kingdom",
        "countryCode": "GB",
        "timeZoneId": "Europe/London"
      },
      "deliveryAddress": {
        "locationId": "9e8d7c6b-5a4f-4e3d-b2c1-a0f9e8d7c6b5",
        "locationName": "Tesco DC Daventry",
        "city": "Daventry",
        "countryCode": "GB"
      },
      "vehicleType": {
        "vehicleTypeId": "3d4e5f6a-7b8c-4d9e-a0b1-c2d3e4f5a6b7",
        "vehicleTypeName": "Truck"
      },
      "trailerType": {
        "trailerTypeId": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
        "trailerTypeName": "Reefer"
      },
      "contacts": [],
      "rates": [
        {
          "startDate": "2026-01-01",
          "endDate": "2026-12-31",
          "rate": 500
        }
      ]
    }
  ]
}