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.

Required scope: integrations:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

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.
  • reason_label — Amazon's ledger reason in words (for example "Misplaced in the fulfillment center"); null when the code is a reimbursement reason or one Amazon has not documented. Timeline ledger records carry the same reason_label next to their 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