Sample - Stripe API
GET/v1/customers/{customer}/cash_balance_transactions

List a customer's cash balance transactions

Lists the transactions that changed a customer's cash balance. Use cursor parameters to page through transactions and limit to control the number returned, with optional response expansion through expand. Each transaction records funds moving into or out of the cash balance.

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

5 parameters
customerstringrequired
The unique identifier of the customer whose cash balance transactions to list. The value must be no more than 5,000 characters.
ending_beforestringoptional
A transaction ID that defines the end of the requested page; use it to retrieve the previous page of transactions. The value must be no more than 5,000 characters.
expandarray<string>optional
Fields to expand in the response; each value must be no more than 5,000 characters.
limitintegeroptional
The number of transactions to return. Must be between 1 and 100 and defaults to 10 when omitted.
starting_afterstringoptional
A transaction ID that defines the start of the requested page; use it to retrieve the next page of transactions. The value must be no more than 5,000 characters.

2 status codes
200Returns a cash balance transaction list containing transaction objects in `data`, a `has_more` pagination flag, the list object type, and the list URL.
dataarray<CashBalanceTransaction>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

customer must be no more than 5,000 characters and must identify the customer whose transactions to list. limit must be between 1 and 100 and defaults to 10 when omitted; use starting_after or ending_before with a transaction ID to navigate pages.