Skip to main content
GET
List Disputes

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.

Query Parameters

limit
integer
default:50

Number of disputes to return. Minimum 1 and maximum 100.

Required range: 1 <= x <= 100
offset
integer
default:0

Number of disputes to skip before returning results.

Required range: x >= 0
status
enum<string>

Filter disputes by status.

Available options:
needs_response,
under_review,
won,
lost,
closed
from_date
string<date-time>

Return disputes created at or after this timestamp (ISO 8601).

to_date
string<date-time>

Return disputes created at or before this timestamp (ISO 8601).

Response

Disputes retrieved successfully.

Paginated dispute list response.

total
integer
required

Total number of disputes matching the query.

items
object[]
required

Dispute records for the requested page.