List Removal Orders (Grouped Across Instances)
GET/api/amazon/unified/removal-orders
Returns paginated removal orders grouped by (order_id, integration_instance_id). Each row is a SUMMARY with aggregated quantities, a representative status/type/disposition, line_count, and a lines array containing line-level rows for expandable UI.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Each row also carries is_straddle (the order's shipment predates the FBA inventory tracking start date) and has_pending_straddle (a straddle line still has pending quantity to reconcile). Use filter[needs_attention]=true to list only orders with pending straddle quantity.
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.