Track & Trace / Shipment Status 🚛

There are three ways to follow a shipment:

A complete list of all status codes and their descriptions is available in this Google Sheet.

Tracking endpoint

Get tracking information for an Order returns two lists:

• trackingSteps — the main milestones: ACCEPTED, DISPOSITION, PICKED_UP, DISPATCHED, UNLOADED, ON_A_WAY_TO_CONSIGNEE and DELIVERED (UNLOADED and ON_A_WAY_TO_CONSIGNEE only for groupage shipments), each with its status and timestamp.
• statusEventHistory — all individual status events with code, message, timestamp, estimated pickup and delivery windows and, after delivery, the name of the signer.

Setting up the webhook

1. Set up an HTTPS endpoint that accepts POST requests with a JSON body.
2. Send the following information to Patrick at [email protected]:
   • the URL of your endpoint
   • authentication details, if your endpoint requires them (optional)
   • your customer number or another clear reference to your customer account (e.g. the registered e-mail address)
3. We configure the webhook. From then on, every status update is sent to your endpoint immediately after it is generated.

Payload

{
  "order": {
    "reference": "string",
    "id": "string",
    "customerId": "string",
    "customerOrderCode": "string"
  },
  "event": {
    "id": "string",
    "statusCode": "string",
    "label": "string",
    "originatedAt": "2025-05-02T12:00:00Z",
    "emittedBy": "string",
    "nameOfSigner": "string",
    "message": "string",
    "estimatedCollectionAtFrom": "2025-05-03T08:00:00Z",
    "estimatedCollectionAtUntil": "2025-05-03T12:00:00Z",
    "estimatedDeliveryAtFrom": "2025-05-05T08:00:00Z",
    "estimatedDeliveryAtUntil": "2025-05-05T18:00:00Z"
  },
  "environment": "production"
}

Main fields