List Cancelled Orders
GET/api/3pl/orders/cancelled
Returns the orders you have already downloaded from List Orders that have since been cancelled in SKU.io, newest cancellation first. Authentication: Requires 3PL integration Bearer token (with 3pl:read ability). Rate limit: 120 requests per 60 seconds.
Called by a channel partner or 3PL with the integration token issued for that connection in SKU.io — not with a Personal Access Token.
SKU.io cannot reach into your warehouse system, so a cancelled order you have already imported stays live there until you cancel it. Poll this list on the same schedule as List Orders (for example with filter[cancelled_since] set to your previous poll time) and cancel each returned order in your system, matching on id or order_number exactly as List Orders served them.
Only orders you downloaded are listed: an order cancelled before you downloaded it never reached you and is left out. Each line's quantity is the full quantity you downloaded. Reading this list changes nothing in SKU.io, so it is safe to poll repeatedly.
If you ship an order that is listed here, Fulfill Order refuses the shipment with a 422 and the merchant is notified.
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.