Skip to main content

List Reimbursement Cases

GET 
/api/amazon/unified/reimbursement-cases

Lists reimbursement cases across Amazon integration instances, paginated. Default order is by urgency (soonest filing deadline first, then largest amount).

Required scope: recovery:read

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

Filters: lifecycle group, status, category, instance, currency, assignee (id, me, none), due within N days, missing cost, case text source, and a search across case ID, SKU, FNSKU, ASIN, Amazon case ID and evidence order/shipment IDs. Advanced text/numeric/date operator filters are supported (see query parameters).

Each case includes its plain-language status label, lifecycle group, days left to file, the one-sentence explanation (why) and evidence rows, case text and provenance, Seller Central filing guidance, and allowed status transitions.

Other per-case fields:

  • informational — true for a heads-up case that can't be filed with Amazon (e.g. reimbursed_then_returned: Amazon is expected to take a reimbursement back because the item was returned). Informational cases never reach ready_to_submit or submitted, are left out of the filing queue, and always have can_submit_now: false.
  • allowed_transitions — the statuses this case can move to, taking its category into account (informational cases never list ready_to_submit or submitted).
  • can_submit_now — whether the case can be filed today: not informational, its claim window has opened and it has not expired.
  • outstanding_amount — the claim value not yet covered by cash paid or inventory returned (0 for a case Amazon paid automatically).
  • inventory_restitution_value — the value of units Amazon returned to your inventory against the filed claim, at the claim's unit value. List rows leave out claim_text_facts (the fact sheet the case text was written from); it is returned by Get Reimbursement Case and Get Filing Session Queue.

Rows with status ready_to_submit also carry proof_of_ownership (see Get Reimbursement Case), so a ready case still missing its supplier invoice can be shown as needing one.

Request​

Responses​

OK

Response Headers
    Content-Type