Returns a list of transactions that have contributed to the Stripe account balance (for example, charges, transfers, and so on). The transactions return in sorted order, with the most recent transactions appearing first.
The previous name of this endpoint was “Balance history,” and it used the path /v1/balance/history.
Parameters
- payoutstring
For automatic Stripe payouts only, only returns transactions that were paid out on the specified payout ID.
- typestring
Only returns transactions of the given type. One of:
tax_,fund adjustment,advance,advance_,funding anticipation_,repayment application_,fee application_,fee_ refund charge,climate_,order_ purchase climate_,order_ refund connect_,collection_ transfer contribution,inbound_,transfer inbound_,transfer_ reversal issuing_,authorization_ hold issuing_,authorization_ release issuing_,dispute issuing_,transaction obligation_,outbound obligation_,reversal_ inbound payment,payment_,failure_ refund payment_,network_ reserve_ hold payment_,network_ reserve_ release payment_,refund payment_,reversal payment_,unreconciled payout,payout_,cancel payout_,failure payout_,minimum_ balance_ hold payout_,minimum_ balance_ release refund,refund_,failure reserve_,transaction reserved_,funds reserve_,hold reserve_,release stripe_,fee stripe_,fx_ fee stripe_,balance_ payment_ debit stripe_,balance_ payment_ debit_ reversal tax_,fee topup,topup_,reversal transfer,transfer_,cancel transfer_,failure transfer_, orrefund fee_.credit_ funding
More parameters
- createdobject
- currencyenum
- ending_
beforestring - limitinteger
- sourcestring
- starting_
afterstring
Returns
A dictionary with a data property that contains an array of up to limit transactions, starting after transaction starting_. Each entry in the array is a separate transaction history object. If no more transactions are available, the resulting array will be empty.
{ "object": "list", "url": "/v1/balance_transactions", "has_more": false, "data": [ { "id": "txn_1MiN3gLkdIwHu7ixxapQrznl", "object": "balance_transaction", "amount": -400, "available_on": 1678043844, "created": 1678043844, "currency": "usd", "description": null, "exchange_rate": null, "fee": 0, "fee_details": [], "net": -400, "reporting_category": "transfer", "source": "tr_1MiN3gLkdIwHu7ixNCZvFdgA", "status": "available", "type": "transfer" } ]}