List FBA Loss Events
GET/api/amazon/unified/fba-loss-events
Lists FBA loss events: each loss of FBA units (from the inventory ledger, or from the reimbursement that paid for a loss the ledger never shows) with what happened to it — reimbursed, reversed, found or still missing. Losses are linked daily after each reimbursement sync. Returns the standard Laravel paginator.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Event fields:
source— ledger_loss (an inventory-ledger adjustment), inbound (a Lost_Inbound reimbursement), customer_return (a CustomerReturn reimbursement;referenceis the Amazon order ID), other.reason_code— the ledger code (M, 5, E, 6, 7, D) or the reimbursement reason.recoverability— never_returns (damaged or disposed), may_reappear (misplaced, lost or not yet returned), cash_only.status— researching (inside Amazon's 30-day research window), confirmed_lost, partially_reimbursed, reimbursed (every missing unit paid in cash or replaced), found (every unit turned up before any payment), reversed (units turned up after payment), written_off (claim window closed with units neither found nor paid).- Quantities:
quantity_lost,quantity_found,quantity_cash_reimbursed,quantity_replaced(Amazon put a unit back instead of paying),quantity_reversed,quantity_outstanding. cost_total— the FIFO cost the lost units consumed, incost_currency(your base currency; null when unknown);reimbursed_totalandreversed_total(negative) incurrency— the currency Amazon paid in (null when the payments came in more than one currency);variance— net paid minus the cost of the units paid for (null when either side is unknown, or whencurrencydiffers fromcost_currency— amounts are never compared unconverted).research_ends_at,claim_deadline— dates;resolved_at— when the event stopped waiting on Amazon.
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.