Skip to main content

Transition Reimbursement Case Status

POST 
/api/amazon/unified/reimbursement-cases/:reimbursementCase/transition

Moves a reimbursement case to a new lifecycle status, enforcing the allowed transitions and recording a case note describing the change.

Authorization

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

Request body fields:

  • status (required) — target status, one of: potential, under_review, ready_to_submit, submitted, partially_reimbursed, reimbursed, denied, dismissed, expired.
  • reason (optional, string, max 255) — stored as the dismissal/denial reason when moving to dismissed or denied, and appended to the transition note.
  • amazon_case_id (optional, string, max 64) — when provided together with status=submitted, the case is marked as submitted to Amazon with this Seller Central case ID and submitted_at is stamped (the case must currently be in potential, under_review or ready_to_submit).

Allowed transitions:

  • potential -> under_review, ready_to_submit, submitted, dismissed, expired
  • under_review -> potential, ready_to_submit, submitted, dismissed, expired
  • ready_to_submit -> under_review, submitted, dismissed, expired
  • submitted -> partially_reimbursed, reimbursed, denied
  • partially_reimbursed -> reimbursed, denied
  • reimbursed, denied, dismissed and expired are terminal (no outgoing transitions). Transitioning to the current status is a no-op.

An invalid transition returns HTTP 422 with an error message.

Request​

Responses​

OK

Response Headers
    Content-Type