List Orders (Outbound Fulfillments)
GET/api/3pl/orders
Returns paginated outbound fulfillment orders for the 3PL's warehouses. Authentication: Requires 3PL integration Bearer token (with 3pl:read ability). Rate limit: 120 requests per 60 seconds.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Each order now also returns its lifecycle state: request_status (submitted=Released, accepted=Downloaded, acknowledged=Acknowledged), downloaded_at, and acknowledged_at. Acknowledged orders remain in this list until they ship.
The order_number is the FulfillmentOrder's sequenced reference {sales_order_number}.{sequence} (e.g. #14522.1) — one routed slice of the sales order. The .{sequence} suffix distinguishes slices and re-submits after a void; pull partners (e.g. D3) match orders on this value. Each line's id is the FulfillmentOrderLine id (echo it back on fulfill) and quantity is the remaining quantity still to ship.
Orders dispatched to another provider are excluded. A fulfillment order at one of your warehouses that SKU.io sent to a different shipping provider (for example, a warehouse routing rule sends it to a white-glove carrier that picks it up from your dock) is not yours to ship and never appears in this list. Acknowledge Order and Fulfill Order return 404 for such an order.
Request
Responses
- 200
- 401
- 403
- 429
OK
Response Headers
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.