List Disputes
Returns a list of your disputes, most recent first.
Evidence is omitted by default; pass expand=evidence to include the parsed evidence for each dispute.
Authorizations
Use a Bearer token to access this API.
Query Parameters
Maximum number of disputes to return (default 20, max 100).
10
A cursor for use in pagination. starting_after is a dispute ID that defines your place in the list. For instance, if you make a list request and receive 20 disputes, ending with fdp_xyz, your subsequent call can include starting_after=fdp_xyz to fetch the next page of the list.
"fdp_01J9XR8M3K7VZ8N2YB4WJ6T0RA"
A cursor for use in pagination. ending_before is a dispute ID that defines your place in the list. For instance, if you make a list request and receive 20 disputes, starting with fdp_abc, your subsequent call can include ending_before=fdp_abc to fetch the previous page of the list.
"fdp_01J9XR8M3K7VZ8N2YB4WJ6T0RA"
Filter by charge ID.
"fch_01J9XR8M3K7VZ8N2YB4WJ6T0RA"
Filter by payment intent ID.
"fpi_01J9XR8M3K7VZ8N2YB4WJ6T0RA"
Filter by dispute statuses (comma-separated, e.g. ?statuses=needs_response,under_review).
The current status of a dispute.
lost, needs_response, under_review, warning_closed, warning_needs_response, warning_under_review, won "lost"
"needs_response"
Comma-separated list of fields to expand (e.g., ?expand=evidence).
Response
An envelope wrapping a list of dispute objects.
An envelope wrapping a list of dispute objects.
The list of disputes.