Skip to main content

Create Reimbursement Case

POST 
/api/amazon/unified/reimbursement-cases

Creates a reimbursement case manually. Creation is idempotent on idempotency_key — if a case with the same key already exists, that case is returned instead of creating a duplicate.

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Request body fields:

  • integration_instance_id (required, integer) — Amazon integration instance the case belongs to.
  • category (required) — one of: warehouse_lost, warehouse_damaged, customer_return_not_received, customer_return_damaged, customer_return_refund_mismatch, inbound_shortage, removal_order_discrepancy, fba_fee_overcharge, chargeback_reversal, destroyed_without_authorization.
  • status (optional) — one of: potential, under_review, ready_to_submit, submitted, partially_reimbursed, reimbursed, denied, dismissed, expired. Defaults to potential.
  • flagged_at (optional, date) — when the discrepancy was flagged.
  • claim_window_expires_at (required, date, must be in the future) — last day a claim can be filed with Amazon.
  • sku (optional, string, max 64) / fnsku (optional, string, max 32) / asin (optional, string, max 32).
  • product_id (optional, integer) — SKU.io product ID.
  • amazon_fnsku_product_id (optional, integer) — Amazon FNSKU product ID.
  • quantity (required, integer >= 0) — affected units.
  • unit_cost (required, numeric >= 0) and unit_cost_source (optional, string, max 32, e.g. fifo, manual).
  • potential_amount (required, numeric >= 0) — expected recovery amount.
  • currency (required, 3-letter ISO code).
  • idempotency_key (required, string, max 191) — unique key for deduplication.
  • source_reference_type (optional, string, max 64) and source_reference_id (optional, integer) — pointer to the record that evidences the discrepancy.
  • evidence (optional, object) — free-form supporting data.
  • claim_text (optional, string) — pre-drafted text for the Seller Central case.
  • assigned_user_id (optional, integer) — user responsible for the case.

Returns the created (or pre-existing) case with HTTP 201.

Request​

Responses​

Created

Response Headers
    Content-Type