Skip to main content
GET
List Disputes

Authorizations

Authorization
string
header
required

Use a Bearer token to access this API.

Query Parameters

limit
integer<int64> | null

Maximum number of disputes to return (default 20, max 100).

Example:

10

starting_after
string | null

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.

Example:

"fdp_01J9XR8M3K7VZ8N2YB4WJ6T0RA"

ending_before
string | null

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.

Example:

"fdp_01J9XR8M3K7VZ8N2YB4WJ6T0RA"

charge
string | null

Filter by charge ID.

Example:

"fch_01J9XR8M3K7VZ8N2YB4WJ6T0RA"

payment_intent
string | null

Filter by payment intent ID.

Example:

"fpi_01J9XR8M3K7VZ8N2YB4WJ6T0RA"

statuses
enum<string>[] | null

Filter by dispute statuses (comma-separated, e.g. ?statuses=needs_response,under_review).

The current status of a dispute.

Available options:
lost,
needs_response,
under_review,
warning_closed,
warning_needs_response,
warning_under_review,
won
Example:

"lost"

Example:

"needs_response"

expand
string
default:""

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.

disputes
object[]
required

The list of disputes.