Stripe: List all Checkout Sessions

← Checkout operations · Get started

Operation stripe.getcheckoutsessions

Provider route: GET /v1/checkout/sessions. 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["checkout"]["getCheckoutSessions"]>[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.checkout.getCheckoutSessions(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.checkout.get_checkout_sessions(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.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.customer	string	Optional	Maximum length: 5000
query.customer_account	string	Optional	Maximum length: 5000
query.customer_details	object	Optional
query.customer_details.email	string	Required within parent
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.payment_intent	string	Optional	Maximum length: 5000
query.payment_link	string	Optional	Maximum length: 5000
query.starting_after	string	Optional	Maximum length: 5000
query.status	string	Optional	One of: complete, expired, open
query.subscription	string	Optional	Maximum length: 5000

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 Create a Checkout Session — 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

Referenced models: Create a Checkout Session — response body

Schemas

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

Create a Checkout Session — response body — wallet options value link

Field	Type	Presence	Description and constraints
$	object	Root
link	Model	Optional	Expand Create a Checkout Session — response body — wallet options value link link

Referenced models: Create a Checkout Session — response body — wallet options value link link

Delete a customer — response body

Field	Type	Presence	Description and constraints
$	object	Root
deleted	boolean	Required within parent	Always true for a deleted object Known values: True
id	string	Required within parent	Unique identifier for the object. Maximum length: 5000
object	string	Required within parent	String representing the object's type. Objects of the same type share the same value. Known values: customer

Retrieve a quote's line items — response body — data item

Field	Type	Presence	Description and constraints
$	object	Root	A line item.
adjustable_quantity	JSON	Optional
adjustable_quantity (anyOf 1)	JSON	Alternative
adjustable_quantity (anyOf 1) (anyOf 1)	Model	Alternative	Expand Retrieve a quote's line items — response body — data item adjustable quantity value enabled, maximum, minimum
adjustable_quantity (anyOf 2)	null	Alternative
amount_discount	JSON	Required within parent
amount_discount (anyOf 1)	integer	Alternative	Total discount amount applied. If no discounts were applied, defaults to 0.
amount_discount (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
amount_subtotal	JSON	Required within parent
amount_subtotal (anyOf 1)	integer	Alternative	Total before any discounts or taxes are applied.
amount_subtotal (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
amount_tax	JSON	Required within parent
amount_tax (anyOf 1)	integer	Alternative	Total tax amount applied. If no tax was applied, defaults to 0.
amount_tax (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
amount_total	JSON	Required within parent
amount_total (anyOf 1)	integer	Alternative	Total after discounts and taxes.
amount_total (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	JSON	Optional
description (anyOf 1)	string	Alternative	An arbitrary string attached to the object. Often useful for displaying to users. Defaults to product name. Maximum length: 5000
description (anyOf 2)	null	Alternative
discounts	array	Optional	The discounts applied to the line item.
discounts[]	Model	Each item	Expand Retrieve a quote's line items — response body — data item discounts item
id	string	Required within parent	Unique identifier for the object. Maximum length: 5000
metadata	JSON	Optional
metadata (anyOf 1)	object	Alternative	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 (anyOf 1).*	string	Additional keys	Maximum length: 500
metadata (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: item
price	JSON	Optional
price (anyOf 1)	JSON	Alternative	The price used to generate the line item.
price (anyOf 1) (anyOf 1)	Model	Alternative	Expand Create a price — response body
price (anyOf 2)	null	Alternative
quantity	JSON	Optional
quantity (anyOf 1)	JSON	Alternative
quantity (anyOf 1) (anyOf 1)	integer	Alternative	The quantity of products being purchased.
quantity (anyOf 1) (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
quantity (anyOf 2)	null	Alternative
taxes	array	Optional	The taxes applied to the line item.
taxes[]	Model	Each item	Expand Retrieve a quote's line items — response body — data item taxes item

Referenced models: Retrieve a quote's line items — response body — data item adjustable quantity value enabled, maximum, minimum, Retrieve a quote's line items — response body — data item discounts item, Retrieve a quote's line items — response body — data item taxes item, Create a price — response body

Cancel a refund — response body — presentment details

Field	Type	Presence	Description and constraints
$	object	Root
presentment_amount	JSON	Required within parent
presentment_amount (anyOf 1)	integer	Alternative	Amount intended to be collected by this payment, denominated in `presentment_currency`.
presentment_amount (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
presentment_currency	string	Required within parent	Currency presented to the customer during payment. Maximum length: 5000

Create a payment link — response body — custom text

Field	Type	Presence	Description and constraints
$	object	Root
after_submit	JSON	Optional
after_submit (anyOf 1)	JSON	Alternative	Custom text that should be displayed after the payment confirmation button.
after_submit (anyOf 1) (anyOf 1)	Model	Alternative	Expand Create a payment link — response body — custom text submit value message
after_submit (anyOf 2)	null	Alternative
shipping_address	JSON	Optional
shipping_address (anyOf 1)	JSON	Alternative	Custom text that should be displayed alongside shipping address collection.
shipping_address (anyOf 1) (anyOf 1)	Model	Alternative	Expand Create a payment link — response body — custom text submit value message
shipping_address (anyOf 2)	null	Alternative
submit	JSON	Optional
submit (anyOf 1)	JSON	Alternative	Custom text that should be displayed alongside the payment confirmation button.
submit (anyOf 1) (anyOf 1)	Model	Alternative	Expand Create a payment link — response body — custom text submit value message
submit (anyOf 2)	null	Alternative
terms_of_service_acceptance	JSON	Optional
terms_of_service_acceptance (anyOf 1)	JSON	Alternative	Custom text that should be displayed in place of the default terms of service agreement text.
terms_of_service_acceptance (anyOf 1) (anyOf 1)	Model	Alternative	Expand Create a payment link — response body — custom text submit value message
terms_of_service_acceptance (anyOf 2)	null	Alternative

Referenced models: Create a payment link — response body — custom text submit value message

Cancel a Setup Intent — response body — payment method configuration details value id, parent

Field	Type	Presence	Description and constraints
$	object	Root
id	string	Required within parent	ID of the payment method configuration used. Maximum length: 5000
parent	JSON	Optional
parent (anyOf 1)	string	Alternative	ID of the parent payment method configuration used. Maximum length: 5000
parent (anyOf 2)	null	Alternative

Create a Checkout Session — response body — adaptive pricing value enabled

Field	Type	Presence	Description and constraints
$	object	Root
enabled	boolean	Required within parent	If enabled, Adaptive Pricing is available on [eligible sessions](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing?payment-ui=stripe-hosted#restrictions).

Create a Checkout Session — response body — invoice creation value enabled, invoice data

Field	Type	Presence	Description and constraints
$	object	Root
enabled	boolean	Required within parent	Indicates whether invoice creation is enabled for the Checkout Session.
invoice_data	Model	Required within parent	Expand Create a Checkout Session — response body — invoice creation value enabled, invoice data invoice data

Referenced models: Create a Checkout Session — response body — invoice creation value enabled, invoice data invoice data

Policy, approvals and errors

SDK function policy ID: stripe.getcheckoutsessions. Catalog operation: GetCheckoutSessions. 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