Stripe: List all transactions

← Issuing operations · Get started

Operation stripe.getissuingtransactions

Provider route: GET /v1/issuing/transactions. Alter supplies the connection’s credentials and routing.

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["issuing"]["getIssuingTransactions"]>[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.issuing.getIssuingTransactions(input);
    const result = await call.wait();
    return result.bodyJson();
  } finally {
    await app.close();
  }
}

import os
from alter_sdk import App
from 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.issuing.get_issuing_transactions(arguments)
        result = await call.wait()
        return result.body_json()

Input

Field	Type	Presence	Description and constraints
$	object	Root	Additional keys: not allowed
query	object	Optional	Additional keys: not allowed
query.card	string	Optional	Maximum length: 5000
query.cardholder	string	Optional	Maximum length: 5000
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.ending_before	string	Optional	Maximum length: 5000
query.expand	array	Optional
query.expand[]	string	Each item	Maximum length: 5000
query.limit	integer	Optional
query.starting_after	string	Optional	Maximum length: 5000
query.type	string	Optional	One of: capture, refund

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
data[]	Model	Each item	Expand Update a transaction — 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/issuing/transactions

Referenced models: Update a transaction — response body

Schemas

707 more schemas are linked from the tables above, on the schema pages.

Update a transaction — response body

Field	Type	Presence	Description and constraints
$	object	Root	Any use of an [issued card](https://docs.stripe.com/issuing) that results in funds entering or leaving your Stripe account, such as a completed purchase or refund, is represented by an Issuing `Transaction` object. Related guide: [Issued card transactions](https://docs.stripe.com/issuing/purchases/transactions)
amount	JSON	Required within parent
amount (anyOf 1)	integer	Alternative	The transaction amount, which will be reflected in your balance. This amount is in your currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
amount (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
amount_details	JSON	Optional
amount_details (anyOf 1)	JSON	Alternative	Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
amount_details (anyOf 1) (anyOf 1)	Model	Alternative	Expand Update a transaction — response body — amount details value atm fee, cashback amount
amount_details (anyOf 2)	null	Alternative
authorization	JSON	Optional
authorization (anyOf 1)	JSON	Alternative	The `Authorization` object that led to this transaction.
authorization (anyOf 1) (anyOf 1)	string	Alternative	Maximum length: 5000
authorization (anyOf 1) (anyOf 2)	Model	Alternative	Expand Update an authorization — response body
authorization (anyOf 2)	null	Alternative
balance_transaction	JSON	Optional
balance_transaction (anyOf 1)	JSON	Alternative	ID of the [balance transaction](https://docs.stripe.com/api/balance_transactions) associated with this transaction.
balance_transaction (anyOf 1) (anyOf 1)	string	Alternative	Maximum length: 5000
balance_transaction (anyOf 1) (anyOf 2)	Model	Alternative	Expand Retrieve a balance transaction — balance get Balance History Id — response body
balance_transaction (anyOf 2)	null	Alternative
card	JSON	Required within parent	The card used to make this transaction.
card (anyOf 1)	string	Alternative	Maximum length: 5000
card (anyOf 2)	Model	Alternative	Expand Fail a testmode card — response body
cardholder	JSON	Optional
cardholder (anyOf 1)	JSON	Alternative	The cardholder to whom this transaction belongs.
cardholder (anyOf 1) (anyOf 1)	string	Alternative	Maximum length: 5000
cardholder (anyOf 1) (anyOf 2)	Model	Alternative	Expand Create a cardholder — response body
cardholder (anyOf 2)	null	Alternative
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
dispute	JSON	Optional
dispute (anyOf 1)	JSON	Alternative	If you've disputed the transaction, the ID of the dispute.
dispute (anyOf 1) (anyOf 1)	string	Alternative	Maximum length: 5000
dispute (anyOf 1) (anyOf 2)	Model	Alternative	Expand Create a dispute — response body
dispute (anyOf 2)	null	Alternative
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`.
merchant_amount	JSON	Required within parent
merchant_amount (anyOf 1)	integer	Alternative	The amount that the merchant will receive, denominated in `merchant_currency` and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). It will be different from `amount` if the merchant is taking payment in a different currency.
merchant_amount (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
merchant_currency	string	Required within parent	The currency with which the merchant is taking payment. Format: currency
merchant_data	Model	Required within parent	Expand Update a transaction — response body — merchant data
metadata	object	Required within parent	Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Additional keys: see wildcard field
metadata.*	string	Additional keys	Maximum length: 500
network_data	JSON	Optional
network_data (anyOf 1)	JSON	Alternative	Details about the transaction, such as processing dates, set by the card network.
network_data (anyOf 1) (anyOf 1)	Model	Alternative	Expand Update a transaction — response body — network data value authorization code, processing date, transaction id
network_data (anyOf 2)	null	Alternative
object	string	Required within parent	String representing the object's type. Objects of the same type share the same value. Known values: issuing.transaction
purchase_details	JSON	Optional
purchase_details (anyOf 1)	JSON	Alternative	Additional purchase information that is optionally provided by the merchant.
purchase_details (anyOf 1) (anyOf 1)	Model	Alternative	Expand Update a transaction — response body — purchase details value fleet, flight, fuel, lodging, receipt, reference
purchase_details (anyOf 2)	null	Alternative
token	JSON	Optional
token (anyOf 1)	JSON	Alternative	[Token](https://docs.stripe.com/api/issuing/tokens/object) object used for this transaction. If a network token was not used for this transaction, this field will be null.
token (anyOf 1) (anyOf 1)	string	Alternative	Maximum length: 5000
token (anyOf 1) (anyOf 2)	Model	Alternative	Expand Update a token status — response body
token (anyOf 2)	null	Alternative
treasury	JSON	Optional
treasury (anyOf 1)	JSON	Alternative	[Treasury](https://docs.stripe.com/api/treasury) details related to this transaction if it was created on a [FinancialAccount](/docs/api/treasury/financial_accounts
treasury (anyOf 1) (anyOf 1)	Model	Alternative	Expand Update a transaction — response body — treasury value received credit, received debit
treasury (anyOf 2)	null	Alternative
type	string	Required within parent	The nature of the transaction. Known values: capture, refund
wallet	JSON	Optional
wallet (anyOf 1)	string	Alternative	The digital wallet used for this transaction. One of `apple_pay`, `google_pay`, or `samsung_pay`. Known values: apple_pay, google_pay, samsung_pay
wallet (anyOf 2)	null	Alternative

Referenced models: Retrieve a balance transaction — balance get Balance History Id — response body, Update an authorization — response body, Fail a testmode card — response body, Create a cardholder — response body, Create a dispute — response body, Update a token status — response body, Update a transaction — response body — amount details value atm fee, cashback amount, Update a transaction — response body — merchant data, Update a transaction — response body — network data value authorization code, processing date, transaction id, Update a transaction — response body — purchase details value fleet, flight, fuel, lodging, receipt, reference, Update a transaction — response body — treasury value received credit, received debit

Update a transaction — response body — amount details value atm fee, cashback amount

Field	Type	Presence	Description and constraints
$	object	Root
atm_fee	JSON	Optional
atm_fee (anyOf 1)	JSON	Alternative
atm_fee (anyOf 1) (anyOf 1)	integer	Alternative	The fee charged by the ATM for the cash withdrawal.
atm_fee (anyOf 1) (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
atm_fee (anyOf 2)	null	Alternative
cashback_amount	JSON	Optional
cashback_amount (anyOf 1)	JSON	Alternative
cashback_amount (anyOf 1) (anyOf 1)	integer	Alternative	The amount of cash requested by the cardholder.
cashback_amount (anyOf 1) (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
cashback_amount (anyOf 2)	null	Alternative

Policy, approvals and errors

SDK function policy ID: stripe.getissuingtransactions. Catalog operation: GetIssuingTransactions. 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"}

Official provider source