Skip to main content
POST
Open a dispute

Authorizations

Authorization
string
header
required

Your platform API key.

Headers

Idempotency-Key
string

Retry safely: a repeat with the same key and body returns the first response. The same key with a different body returns 422.

Maximum string length: 255

Body

application/json
category
string
required
amount_cents
integer
required
opened_by
enum<string>
required
Available options:
buyer,
seller
reason
string
required
buyer
object
required
seller
object
required
external_reference
string
currency
string
Allowed value: "USD"
transaction
object

Response

Opened.

id
string
reference
string
external_reference
string | null
status
enum<string>
Available options:
open,
deciding,
needs_review,
decided,
awaiting_agreement,
escalated,
closed,
withdrawn
category
string
amount_cents
integer
currency
string
opened_by
string
policy_version
integer
evidence_due_at
string<date-time>
review_due_at
string<date-time> | null
submissions
integer
parties
object[]
decision
object | null

Outcome (refund_full, refund_partial, no_refund), refund_cents, return_required, reasons, citations, confidence, decided_by (ai or platform), reviewer.

arbitration_case_id
string | null