GET
/v1/issuing/disputesList Issuing disputes
Lists Issuing disputes in descending creation order, with the most recently created dispute first. Use created, status, and transaction to filter results, and use starting_after or ending_before to navigate between pages. Use limit to control page size and expand to request expanded response fields.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
createdobjectoptional
Filter disputes by creation time using a Unix timestamp or a range with `gt`, `gte`, `lt`, or `lte`.
ending_beforestringoptional
Cursor identifying an object before which to return the previous page. Maximum 5000 characters.
expandarray<string>optional
Fields to expand in the response. Each field name may be up to 5000 characters.
limitintegeroptional
Number of disputes to return, from 1 to 100. Defaults to 10 when omitted.
starting_afterstringoptional
Cursor identifying an object after which to return the next page. Maximum 5000 characters.
statusstringoptional
Filter by dispute status: expired, lost, submitted, unsubmitted, or won.
transactionstringoptional
Filter for the dispute associated with the specified transaction. Maximum 5000 characters.
200Returns a list object containing Issuing dispute objects in descending creation order, a `has_more` indicator, 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.
defaultReturned when the request cannot be processed; the response contains an `error` object with a reason and error type.
errorobjectrequired
Error handling
limit must be between 1 and 100 and defaults to 10 when omitted. status must be one of: expired, lost, submitted, unsubmitted, or won; created must be a Unix timestamp or a range object using gt, gte, lt, or lte.