CtrlChain Developers
Get an API key
CtrlChain API · part of NewCold

Build freight into your own systems.

One REST API to book shipments on your contracted lanes and follow every order on the CtrlChain freight network — from your TMS, ERP, or warehouse system.

Read the quick-start Explore the API
POST /api/v1/Request/lane-booking
curl https://api.ctrlchain.com/api/v1/Request/lane-booking \
  -H "apiKey: $CTRLCHAIN_API_KEY" \
  -d '{
    "laneId": "5a1c9e7d-2b3f-4a6c-8d9e-0f1a2b3c4d5e",
    "groupId": "8c2e1b4a-9d3f-4c5e-a6b7-c8d9e0f1a2b3",
    "userId": "b9b0054f-000f-4e0d-a529-555f31821541",
    "tailLift": false
  }'

HTTP/1.1 200 OK
{
  "ccaRequestReferenceNumber": "CCA2026-007873",
  "ccaOrderReferenceNumber": "CCA2026-007873.1"
}

Five APIs, one freight network

Everything runs over the same base URL and the same API key. Start with Users and Lanes to gather your booking ids; add Webhooks to stay in sync.

Users
Groups and booking users in your enterprise — the ids you need to place a booking.
Documentation API
Lanes
Your contracted routes — locations, vehicle and trailer type, and agreed rates.
Documentation API
Requests
Place a booking on a lane. A valid request immediately creates an order.
Documentation API
Orders
Confirmed shipments — status, stops, carrier details, and PODs.
Documentation API
Webhooks
Status updates pushed to your endpoint, with APIs to list and retrigger events.
Documentation API

Your first call in three steps

No self-serve signup — keys are issued per company, so your integration is production-ready from day one.

1
Get your API key

Ask your CtrlChain account manager or info@ctrlchain.com. Keys are issued per enterprise and scoped to your own groups, lanes, and orders.

2
Make your first request
curl https://api.ctrlchain.com/api/v1/Lane/get-lanes \
  -H "apiKey: $KEY"

Lanes are your contracted routes — every booking starts from one.

3
Book and stay in sync

Place a lane booking — a valid request immediately creates an order — and have webhook notifications enabled so status changes are pushed to you, no polling.

See the endpoints →

What teams build on it

Book freight from your TMS

Shippers place lane bookings straight from their planning system, on the lanes and rates already agreed with CtrlChain.

Requests guide →
Status updates in your portal

Pickup and delivery ETAs, confirmations, and POD approvals pushed to your systems the moment they happen.

Webhooks guide →
Master data in sync

Keep lanes, booking users, and order references aligned between CtrlChain and your own back office.

Lanes guide →