Skip to main content

Get FBA Loss Event

GET 
/api/amazon/unified/fba-loss-events/:lossEvent

Gets one FBA loss event with its timeline: every linked inventory-ledger row, reimbursement, reversal, found unit and settlement line, oldest first. Each timeline entry has role (loss, found, replacement, reimbursement, reversal, settlement), method (ledger, heuristic, reversal, order, manual), the linked quantity/amount, unit_cost (the cost the loss consumed per unit), and record — the key fields of the linked record (for a settlement line this includes its own currency). Records you removed from the event are not shown.

Not yet available to API tokens

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; reference is 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, in cost_currency (your base currency; null when unknown); reimbursed_total and reversed_total (negative) in currency — 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 when currency differs from cost_currency — amounts are never compared unconverted).
  • research_ends_at, claim_deadline — dates; resolved_at — when the event stopped waiting on Amazon.

Request​

Responses​

OK

Response Headers
    Content-Type