Get Customer Return (Per Instance)
GET/api/amazon/:integrationInstance/ledgers/customer-returns/:customer_return
Get a single FBA customer return report row by ID. Rows are imported from the Amazon FBA customer returns report and describe one returned unit event: order_id, sku, asin, fnsku, product_name, quantity, fulfillment_center_id, detailed_disposition (e.g. SELLABLE, CUSTOMER_DAMAGED), reason, status, license_plate_number, customer_comments, plus review metadata (reviewed_at) and the return timestamps (return_date, event_datetime) in UTC ISO 8601 format.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
linked_sales_order is populated on the list endpoints (where matching sales orders are resolved in bulk) and is null on this detail endpoint. Returns 404 for an unknown ID.
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.