Sample - Stripe API
GET/v1/treasury/debit_reversals

List debit reversals

Lists debit reversals associated with a financial account. Use received_debit, resolution, and status to filter the results, and use cursor parameters to paginate through the account's debit reversals.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

8 parameters
ending_beforestringoptional
Cursor object ID used to fetch the page before the specified position.
expandarray<string>optional
Fields to expand in the response.
financial_accountstringrequired
The unique identifier of the financial account associated with the debit reversals.
limitintegeroptional
Maximum number of debit reversals to return, from 1 to 100. Defaults to 10 when omitted.
received_debitstringoptional
Filter results to reversals for the specified received debit ID.
resolutionstringoptional
Filter by resolution: `lost` or `won`.
Allowed:lostwon
starting_afterstringoptional
Cursor object ID used to fetch the page after the specified position.
statusstringoptional
Filter by debit reversal status: `canceled`, `completed`, or `processing`.
Allowed:canceledcompletedprocessing

2 status codes
200Returns a paginated list object containing debit reversal objects in `data`, a `has_more` indicator, the list object type, and the collection URL.
dataarray<DebitReversal>required
Details about each object.
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`.
Allowed:list
urlstringrequired
The URL where this list can be accessed.
defaultError response.
errorobjectrequired

Error handling

financial_account must identify the financial account whose debit reversals you want to retrieve. resolution must be lost or won, status must be canceled, completed, or processing, and limit must be between 1 and 100 when provided.