List Merged Shipments
GET/api/v2/merged-shipments
Returns a paginated list of merged shipments (sales-order merge groups).
Required scope:
orders:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token.
Query Parameters:
- page (integer): Page number (default 1)
- per_page (integer): Items per page (default 10)
- sort (string): One of id, merged_shipment_number, status, created_at, shipped_at. Prefix with - for descending. Default -id.
- filter[id]: Exact match
- filter[status]: Exact match on status enum (awaiting_pack, awaiting_label, awaiting_ship, shipped, cancelled, unmerged)
- filter[warehouse_id]: Exact match
- filter[merged_shipment_number]: Partial match
- filter[open_only]: Boolean — restricts to in-progress merge groups (excludes cancelled/unmerged/shipped)
Request
Responses
- 200
- 401
- 403
- 429
OK
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.