SEND Packages API

Ordered milestones for full-container ocean cargo.

#	Milestone	Meaning	Source
1	Booked	Quote confirmed with parties recorded	quote
2	Arrived at Origin Warehouse	Cargo received; parcel created	parcel
3	Loaded into Container	Container stuffed and sealed	parcel
4	Departed Warehouse	Container left the origin warehouse	shipment
5	Arrived Origin Port	Container gated in at the origin port	shipment
6	Export Clearance	Origin export formalities complete	shipment
7	Loaded on Vessel	Container loaded aboard	shipment
8	Departed Origin Port	Vessel sailed	shipment
9	Arrived Destination Port	Vessel arrived	shipment
10	Customs Clearance	Destination import formalities complete	shipment
11	Arrived Destination Warehouse	Cargo received at destination	shipment
12	Delivery In Progress	Out for final delivery	shipment
13	Delivered	Final milestone; delivery confirmed	shipment

Completed steps carry status: complete and a completed_on date. Steps not yet reached are pending (or processing while underway) with no timestamp — missing events are never backfilled. Assigning a shipment alone completes nothing; receipt and loading complete only when operations records them.

Example response (GET /v1/packages/{parcel_id}/track):

{
  "parcel_id": "abc123",
  "status": "warehouse",
  "tracking_data": [
    { "step": "Booked", "status": "complete", "completed_on": "10 Sep, 2026", "source": "quote" },
    { "step": "Arrived at Origin Warehouse", "status": "complete", "completed_on": "12 Sep, 2026", "source": "parcel" },
    { "step": "Loaded into Container", "status": "pending", "completed_on": null, "source": "parcel" },
    { "step": "Departed Warehouse", "status": "pending", "completed_on": null, "source": "shipment" }
  ]
}