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.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
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.
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.