Sample - Stripe API
GET/v1/treasury/transactions

List financial account transactions

Lists transactions that represent changes to a financial account's balance. Filter by status, creation time, posting time, and flow, and use cursor parameters to paginate the results.

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

9 parameters
createdobjectoptional
Filters transactions by creation time using a Unix timestamp or a range with `gt`, `gte`, `lt`, or `lte`.
ending_beforestringoptional
An object ID cursor that returns results preceding the specified item.
expandarray<string>optional
Fields to expand in each returned object.
financial_accountstringrequired
The FinancialAccount associated with the transactions.
limitintegeroptional
Maximum number of objects to return, from 1 to 100. Defaults to 10 when omitted.
order_bystringoptional
Sorts results in reverse chronological order by `created` or `posted_at`. Defaults to `created` when omitted.
Allowed:createdposted_at
starting_afterstringoptional
An object ID cursor that returns results following the specified item.
statusstringoptional
Filters results by status: `open`, `posted`, or `void`.
Allowed:openpostedvoid
status_transitionsobjectoptional
Filters by the `posted_at` transition timestamp. Use this only with `status=posted` and `order_by=posted_at`.

2 status codes
200Returns a list object containing financial account transactions in `data`, a `has_more` pagination flag, the list object type, and the list URL.
dataarray<Transaction>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 FinancialAccount associated with the transactions. status must be open, posted, or void, and order_by must be created or posted_at. status_transitions.posted_at can be used only with status=posted and order_by=posted_at; limit ranges from 1 to 100 and defaults to 10 when omitted.