Skip to main content
GET
Get Dispute

Authorizations

Authorization
string
header
required

Bearer token authentication. Pass your API key as Authorization: Bearer sk_.... See Authentication for keys, scopes, and sandbox vs production.

Path Parameters

dispute_id
string
required

Unique identifier for the dispute.

Response

Dispute retrieved successfully.

Detailed dispute payload including evidence and latest submission metadata.

dispute_id
string
required

Unique dispute identifier.

amount
string
required

Disputed amount as a decimal string.

currency
string
required

ISO 4217 currency code for the disputed amount.

status
enum<string>
required

The current state of the dispute. A flat dispute fee is debited from your balance as soon as the dispute record is created, whichever of these states it starts in, and it is not charged again or refunded at resolution. needs_response: the dispute is open against you and you must submit evidence before response_deadline_at; no further funds have moved beyond that fee. under_review: your evidence has been submitted and the outcome is being decided; no further funds have moved beyond that fee. won: the dispute was decided in your favour and you keep the funds, and this state is terminal. lost: the dispute was decided against you, and the disputed amount is additionally debited from your balance, and this state is terminal. closed: the dispute was closed with no further action available to you, and this state is terminal.

Available options:
needs_response,
under_review,
won,
lost,
closed
Example:

"under_review"

is_response_editable
boolean
required

Whether evidence is still editable for this dispute.

evidence
object
required

Evidence fields attached to a dispute response.

created_at
string<date-time>
required

Dispute creation timestamp.

updated_at
string<date-time>
required

Most recent update timestamp.

charge_id
string | null

Associated payment/charge identifier, if linked.

reason
string | null

Dispute reason code reported by the payment network.

response_deadline_at
string<date-time> | null

Evidence submission deadline in ISO 8601 format.

latest_submission
object | null

Most recent submission attempt for this dispute.