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

Retrieve a cash balance transaction

Retrieves a specific transaction that changed a customer's cash balance. Provide the customer and transaction identifiers to retrieve the transaction, and use expand to request additional response fields. The response includes the transaction amount, resulting balance, currency, type, and funding or payment details.

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

3 parameters
customerstringrequired
The unique identifier of the customer whose cash balance transaction to retrieve. The value must be no more than 5,000 characters.
transactionstringrequired
The unique identifier of the cash balance transaction to retrieve.
expandarray<string>optional
Fields to expand in the response; each value must be no more than 5,000 characters.

2 status codes
200Returns the cash balance transaction, including its creation time, currency, customer, ending balance, net amount, transaction type, and associated funding or payment details.
adjusted_for_overdraftobjectoptional
applied_to_paymentobjectoptional
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
currencystringrequired
Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
customerstringrequired
The customer whose available cash balance changed as a result of this transaction.
customer_accountstringoptional
The ID of an Account representing a customer whose available cash balance changed as a result of this transaction.
ending_balanceintegerrequired
The total available cash balance for the specified currency after this transaction was applied. Represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
fundedobjectoptional
idstringrequired
Unique identifier for the object.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
net_amountintegerrequired
The amount by which the cash balance changed, represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). A positive value represents funds being added to the cash balance, a negative value represents funds being removed from the cash balance.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:customer_cash_balance_transaction
refunded_from_paymentobjectoptional
transferred_to_balanceobjectoptional
typestringrequired
The type of the cash balance transaction. New types may be added in future. See [Customer Balance](https://docs.stripe.com/payments/customer-balance#types) to learn more about these types.
Allowed:adjusted_for_overdraftapplied_to_paymentfundedfunding_reversedrefunded_from_paymentreturn_canceledreturn_initiatedtransferred_to_balanceunapplied_from_payment
unapplied_from_paymentobjectoptional
defaultError response.
errorobjectrequired

Error handling

customer must be no more than 5,000 characters, and transaction must identify the cash balance transaction to retrieve. Each expand value must be no more than 5,000 characters when expansion is requested; transaction type values include adjusted_for_overdraft, applied_to_payment, funded, funding_reversed, refunded_from_payment, return_canceled, return_initiated, transferred_to_balance, and unapplied_from_payment.