Stripe: List all Transaction Entries
Stripe treasury.getTreasuryTransactionEntries: arguments, response, policy and SDK examples.
← Treasury operations · Get started
Operation stripe.gettreasurytransactionentries
Provider route: GET /v1/treasury/transaction_entries. Alter supplies the connection’s credentials and routing.
Call through Alter
Section titled “Call through Alter”Install @alter-ai/sdk @alter-ai/stripe with npm, or alter-sdk-stripe with pip. Supply your connected customer’s grant ID and the arguments described below.
import { App } from "@alter-ai/sdk";import { StripeIntegration } from "@alter-ai/stripe";
async function execute(input: Parameters<StripeIntegration["treasury"]["getTreasuryTransactionEntries"]>[0]) { const app = new App({ apiKey: process.env.ALTER_API_KEY! }); try { const provider = new StripeIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! }); const call = await provider.treasury.getTreasuryTransactionEntries(input); const result = await call.wait(); return result.bodyJson(); } finally { await app.close(); }}import osfrom alter_sdk import Appfrom alter_sdk_stripe import StripeIntegration
async def execute(arguments): async with App(api_key=os.environ["ALTER_API_KEY"]) as app: provider = StripeIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]}) call = await provider.treasury.get_treasury_transaction_entries(arguments) result = await call.wait() return result.body_json()| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Additional keys: not allowed |
query | object | Required within parent | Additional keys: not allowed |
query.created | JSON | Optional | |
query.created (anyOf 1) | object | Alternative | |
query.created (anyOf 1).gt | integer | Optional | |
query.created (anyOf 1).gte | integer | Optional | |
query.created (anyOf 1).lt | integer | Optional | |
query.created (anyOf 1).lte | integer | Optional | |
query.created (anyOf 2) | integer | Alternative | |
query.effective_at | JSON | Optional | |
query.effective_at (anyOf 1) | object | Alternative | |
query.effective_at (anyOf 1).gt | integer | Optional | |
query.effective_at (anyOf 1).gte | integer | Optional | |
query.effective_at (anyOf 1).lt | integer | Optional | |
query.effective_at (anyOf 1).lte | integer | Optional | |
query.effective_at (anyOf 2) | integer | Alternative | |
query.ending_before | string | Optional | Maximum length: 5000 |
query.expand | array | Optional | |
query.expand[] | string | Each item | Maximum length: 5000 |
query.financial_account | string | Required within parent | |
query.limit | integer | Optional | |
query.order_by | string | Optional | One of: created, effective_at |
query.starting_after | string | Optional | Maximum length: 5000 |
query.transaction | string | Optional | Maximum length: 5000 |
Response
Section titled “Response”Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
data | array | Required within parent | Details about each object. |
data[] | Model | Each item | Expand Retrieve a Transaction Entry — response body |
has_more | boolean | Required within parent | True if this list has another page of items after this one that can be fetched. |
object | string | Required within parent | String representing the object’s type. Objects of the same type share the same value. Always has the value `list`. Known values: list |
url | string | Required within parent | The URL where this list can be accessed. Maximum length: 5000 Pattern: ^/v1/treasury/transaction_entries |
Referenced models: Retrieve a Transaction Entry — response body
Schemas
Section titled “Schemas”748 more schemas are linked from the tables above, on the schema pages.
Retrieve a Transaction Entry — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | TransactionEntries represent individual units of money movements within a single [Transaction](https://docs.stripe.com/api#transactions). |
balance_impact | Model | Required within parent | Expand Retrieve a Transaction Entry — response body — balance impact |
created | JSON | Required within parent | |
created (anyOf 1) | integer | Alternative | Time at which the object was created. Measured in seconds since the Unix epoch. Format: unix-time |
created (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
currency | string | Required within parent | 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). Format: currency |
effective_at | JSON | Required within parent | |
effective_at (anyOf 1) | integer | Alternative | When the TransactionEntry will impact the FinancialAccount's balance. Format: unix-time |
effective_at (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
financial_account | string | Required within parent | The FinancialAccount associated with this object. Maximum length: 5000 |
flow | JSON | Optional | |
flow (anyOf 1) | string | Alternative | Token of the flow associated with the TransactionEntry. Maximum length: 5000 |
flow (anyOf 2) | null | Alternative | |
flow_details | JSON | Optional | |
flow_details (anyOf 1) | JSON | Alternative | Details of the flow associated with the TransactionEntry. |
flow_details (anyOf 1) (anyOf 1) | Model | Alternative | Expand Retrieve a Transaction Entry — response body — flow details value credit reversal, debit reversal, inbound transfer, issuing authorization, outbound payment, outbound transfer, received credit, received debit, type |
flow_details (anyOf 2) | null | Alternative | |
flow_type | string | Required within parent | Type of the flow associated with the TransactionEntry. Known values: credit_reversal, debit_reversal, inbound_transfer, issuing_authorization, other, outbound_payment, outbound_transfer, received_credit, received_debit |
id | string | Required within parent | Unique identifier for the object. Maximum length: 5000 |
livemode | boolean | Required within parent | If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`. |
object | string | Required within parent | String representing the object's type. Objects of the same type share the same value. Known values: treasury.transaction_entry |
transaction | JSON | Required within parent | The Transaction associated with this object. |
transaction (anyOf 1) | string | Alternative | Maximum length: 5000 |
transaction (anyOf 2) | Model | Alternative | Expand Retrieve a Transaction — treasury get Treasury Transactions Id — response body |
type | string | Required within parent | The specific money movement that generated the TransactionEntry. Known values: credit_reversal, credit_reversal_posting, debit_reversal, inbound_transfer, inbound_transfer_return, issuing_authorization_hold, issuing_authorization_release, other, outbound_payment, outbound_payment_cancellation, outbound_payment_failure, outbound_payment_posting, outbound_payment_return, outbound_transfer, outbound_transfer_cancellation, outbound_transfer_failure, outbound_transfer_posting, outbound_transfer_return, received_credit, received_debit |
Referenced models: Retrieve a Transaction — treasury get Treasury Transactions Id — response body, Retrieve a Transaction Entry — response body — balance impact, Retrieve a Transaction Entry — response body — flow details value credit reversal, debit reversal, inbound transfer, issuing authorization, outbound payment, outbound transfer, received credit, received debit, type
Retrieve a Transaction — treasury get Treasury Transactions Id — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Transactions represent changes to a [FinancialAccount's](https://docs.stripe.com/api#financial_accounts) balance. |
amount | JSON | Required within parent | |
amount (anyOf 1) | integer | Alternative | Amount (in cents) transferred. |
amount (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
balance_impact | Model | Required within parent | Expand Retrieve a Transaction Entry — response body — balance impact |
created | JSON | Required within parent | |
created (anyOf 1) | integer | Alternative | Time at which the object was created. Measured in seconds since the Unix epoch. Format: unix-time |
created (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
currency | string | Required within parent | 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). Format: currency |
description | string | Required within parent | An arbitrary string attached to the object. Often useful for displaying to users. Maximum length: 5000 |
entries | JSON | Optional | |
entries (anyOf 1) | object | Alternative | A list of TransactionEntries that are part of this Transaction. This cannot be expanded in any list endpoints. |
entries (anyOf 1).data | array | Required within parent | Details about each object. |
entries (anyOf 1).data[] | Model | Each item | Expand Retrieve a Transaction Entry — response body |
entries (anyOf 1).has_more | boolean | Required within parent | True if this list has another page of items after this one that can be fetched. |
entries (anyOf 1).object | string | Required within parent | String representing the object's type. Objects of the same type share the same value. Always has the value `list`. Known values: list |
entries (anyOf 1).url | string | Required within parent | The URL where this list can be accessed. Maximum length: 5000 Pattern: ^/v1/treasury/transaction_entries |
entries (anyOf 2) | null | Alternative | |
financial_account | string | Required within parent | The FinancialAccount associated with this object. Maximum length: 5000 |
flow | JSON | Optional | |
flow (anyOf 1) | string | Alternative | ID of the flow that created the Transaction. Maximum length: 5000 |
flow (anyOf 2) | null | Alternative | |
flow_details | JSON | Optional | |
flow_details (anyOf 1) | JSON | Alternative | Details of the flow that created the Transaction. |
flow_details (anyOf 1) (anyOf 1) | Model | Alternative | Expand Retrieve a Transaction Entry — response body — flow details value credit reversal, debit reversal, inbound transfer, issuing authorization, outbound payment, outbound transfer, received credit, received debit, type |
flow_details (anyOf 2) | null | Alternative | |
flow_type | string | Required within parent | Type of the flow that created the Transaction. Known values: credit_reversal, debit_reversal, inbound_transfer, issuing_authorization, other, outbound_payment, outbound_transfer, received_credit, received_debit |
id | string | Required within parent | Unique identifier for the object. Maximum length: 5000 |
livemode | boolean | Required within parent | If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`. |
object | string | Required within parent | String representing the object's type. Objects of the same type share the same value. Known values: treasury.transaction |
status | string | Required within parent | Status of the Transaction. Known values: open, posted, void |
status_transitions | Model | Required within parent | Expand Retrieve a Transaction — treasury get Treasury Transactions Id — response body — status transitions |
Referenced models: Retrieve a Transaction Entry — response body, Retrieve a Transaction — treasury get Treasury Transactions Id — response body — status transitions, Retrieve a Transaction Entry — response body — balance impact, Retrieve a Transaction Entry — response body — flow details value credit reversal, debit reversal, inbound transfer, issuing authorization, outbound payment, outbound transfer, received credit, received debit, type
Retrieve a Transaction Entry — response body — balance impact
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Change to a FinancialAccount's balance |
cash | JSON | Required within parent | |
cash (anyOf 1) | integer | Alternative | The change made to funds the user can spend right now. |
cash (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
inbound_pending | JSON | Required within parent | |
inbound_pending (anyOf 1) | integer | Alternative | The change made to funds that are not spendable yet, but will become available at a later time. |
inbound_pending (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
outbound_pending | JSON | Required within parent | |
outbound_pending (anyOf 1) | integer | Alternative | The change made to funds in the account, but not spendable because they are being held for pending outbound flows. |
outbound_pending (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
Create a Debit Reversal — response body — linked flows Other flows linked to a Debit Reversal issuing dispute
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
issuing_dispute | JSON | Optional | |
issuing_dispute (anyOf 1) | string | Alternative | Set if there is an Issuing dispute associated with the DebitReversal. Maximum length: 5000 |
issuing_dispute (anyOf 2) | null | Alternative |
Policy, approvals and errors
Section titled “Policy, approvals and errors”SDK function policy ID: stripe.gettreasurytransactionentries. Catalog operation: GetTreasuryTransactionEntries. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.
Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.
Pinned headers: {"Stripe-Version": "2026-09-30.endive"}