List Balance Transactions
stripe.list_balance_transactions
ActionBusiness appsconnection required
Calls the Stripe API with the connection's secret key.
List the transactions that changed the Stripe balance, newest first.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Stripe
- Secret shape
- the Stripe secret key (sk_...)
- Resolved by
- config.connection_id, else node.connection_id
Configuration
8 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
type Return only one kind of transaction, such as charge, refund, payout, adjustment, stripe_fee or transfer. | string | No | — | — | charge |
currency Return only transactions in this three-letter currency code. | string | No | — | 3–3 characters | — |
payout Return only the transactions paid out by this payout (po_...) — how you reconcile one bank deposit. | string | No | — | — | — |
limit How many objects to return, 1-100. Stripe defaults to 10. | number | No | 10 | 1–100 | — |
starting_after Cursor: return the page after this object id, for walking forward. | string | No | — | — | — |
ending_before Cursor: return the page before this object id, for walking backward. | string | No | — | — | — |
created_after Only objects created at or after this Unix timestamp, in seconds. | number | No | — | ≥ 0 | — |
created_before Only objects created at or before this Unix timestamp, in seconds. | number | No | — | ≥ 0 | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"limit": 10,
"type": "charge"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
transactions[].id The balance transaction id (txn_...). | string | — |
transactions[].amount Gross amount, in the currency's minor unit. | number | — |
transactions[].net Amount after Stripe fees, in the currency's minor unit. | number | — |
transactions[].fee Stripe fee taken, in the currency's minor unit. | number | — |
transactions[].currency Three-letter lowercase ISO currency code. | string | — |
transactions[].type What moved the money: charge, refund, payout, adjustment, ... | string | — |
transactions[].status available or pending. | string | — |
transactions[].source The object that caused it (a charge or refund id). | string | — |
transactions[].description The description carried over from the source. | string | — |
transactions[].available_on When the funds become available, Unix seconds. | number | — |
transactions[].created Creation time, as a Unix timestamp in seconds. | number | — |
count How many objects this page returned. | number | — |
has_more True when Stripe has a further page to fetch. | boolean | — |
{
"count": 0,
"has_more": false,
"transactions": [
{
"amount": 0,
"available_on": 0,
"created": 0,
"currency": "",
"description": "",
"fee": 0,
"id": "",
"net": 0,
"source": "",
"status": "",
"type": ""
}
]
}See List Balance Transactions run in a workflow.
In a technical demo we add the Stripe connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.