Get Customer Return
GET/api/amazon/unified/customer-returns/:customerReturn
Returns a single FBA customer return report row with its cross-links resolved:
- amazon_product: the matching Amazon listing ({id}), when the SKU resolves
- reviewed_by: the user who marked the row reviewed ({id, name}), null-fielded when unreviewed
- linked_sales_order: the SKU.io sales order created from the original Amazon order ({id, sales_order_number, order_status}), or null when no match
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Other fields include order_id (the Amazon order ID), sku, asin, fnsku, product_name, quantity, fulfillment_center_id, detailed_disposition (e.g. SELLABLE, CUSTOMER_DAMAGED), reason (Amazon's return reason code), status, license_plate_number (LPN), customer_comments, reviewed_at, return_date and event_datetime (UTC).
Optional query parameters included / excluded (URL-encoded JSON arrays of column names) limit which columns are returned.
Request
Responses
- 200
- 401
- 403
- 404
- 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.
Not Found
Response Headers
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.