List Shipments
Returns a paginated list of shipments for an account.
Authorizations
An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.
Headers
Pins the request to a dated API version.
"2026-08-13"
Query Parameters
The account to list shipments for. Defaults to the acting account.
Filter to shipments with this delivery status.
unknown, pre_transit, in_transit, out_for_delivery, delivered, available_for_pickup, return_to_sender, failure, cancelled, error Only shipments fulfilling these payments, each prefixed pay_. Repeat the parameter to pass several, up to 100 per request — one paginated list covers all of them.
Return shipments created before this ISO 8601 timestamp.
Return shipments created after this ISO 8601 timestamp.
The field to sort by.
created_at The sort direction.
asc, desc The number of shipments to return.
A cursor; returns shipments after this position.
The number of shipments to return from the end of the range.
A cursor; returns shipments before this position.

