GET
/v1/disputesList all disputes
Lists disputes associated with your account. Use charge or payment_intent to filter the results, created to constrain the creation interval, and cursor parameters to paginate through the list.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
chargestringoptional
Return only disputes associated with the specified charge identifier, limited to 5,000 characters.
createdobjectoptional
Filter disputes by creation time using an integer Unix timestamp or a range with `gt`, `gte`, `lt`, or `lte` bounds.
ending_beforestringoptional
Object ID cursor for retrieving the previous page of results.
expandarray<string>optional
Fields to expand in the response; each value is a string of no more than 5,000 characters.
limitintegeroptional
Maximum number of disputes to return, from 1 to 100. Defaults to 10 when omitted.
payment_intentstringoptional
Return only disputes associated with the specified PaymentIntent identifier, limited to 5,000 characters.
starting_afterstringoptional
Object ID cursor for retrieving the next page of results.
200Returns a dispute list containing dispute objects in `data`, a `has_more` pagination flag, the list object type, and the list URL.
dataarray<Dispute>required
has_morebooleanrequired
True if this list has another page of items after this one that can be fetched.
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
urlstringrequired
The URL where this list can be accessed.
defaultError response.
errorobjectrequired
Error handling
Use limit between 1 and 100; it defaults to 10 when omitted. charge, payment_intent, ending_before, and starting_after must be valid string identifiers when supplied, and created must be an integer timestamp or a range object with gt, gte, lt, or lte.