Tracking

Tracking Overview

GET /v1/packages/{id}/track returns one combined timeline — clients never merge separate records.

EventSource
BookedParcel quote
Arrived at Origin WarehouseParcel creation and warehouse receipt
Loaded into ContainerApplicable parcel event (ocean)
Departed Warehouse onwardConsolidated shipment
  • Tracking history begins with booking; a parcel does not exist before warehouse receipt.
  • A parcel can have tracking before consolidation.
  • Multiple customers’ parcels may share shipment movement; each customer only sees their own parcel information (shared progress, private details).
  • Origin and destination warehouse arrivals are different events (Arrived at Origin Warehouse vs Arrived Warehouse).
  • Assigning a shipment never auto-completes receipt or loading milestones; missing events stay uncompleted with no invented timestamps.
  • Each step carries its source (quote | parcel | shipment), actual timestamp, and completion state.

Mode sequences: Air · Ocean FCL · Ocean LCL.