Orders & tracking

GET/v1/orders

List shipments

no capability gate

Booked shipments, newest first, cursor-paginated. bucket is the lifecycle slice — the same slices the portal draws — and is the filter you usually want.

Parameters

Name	In	Type	Description
bucket	query	string	Lifecycle slice. One of `rts` · `pickup` · `manifest` · `transit` · `delivered` · `rto` · `exceptions` · `cancelled` · `all`.
limit	query	integer	Page size, 1–1000.
cursor	query	string	From the previous page's `nextCursor`.
awb_number	query	string	Exact AWB.
order_no	query	string	Your own reference.
shipment_type	query	string	Forward or reverse. One of `0` · `1`.
date_from	query	string	Inclusive, `YYYY-MM-DD`. Must match `YYYY-MM-DD`.
date_to	query	string	Inclusive, `YYYY-MM-DD`. Must match `YYYY-MM-DD`.
city	query	string	Destination city, ≤100 characters.

Responses

Status	Meaning
200	`{data:[shipment…], pagination:{mode:"cursor",limit,nextCursor}}`. Each row carries `channel`, `order_value` and `tracking_url`.
400 `bucket: unrecognised`	A bucket outside the list above.
400 `cursor: unrecognised shape`	A cursor we did not issue.