List Checkout Sessions
Returns a list of your Checkout Sessions, most recent first.
Authorizations
Use a Bearer token to access this API.
Query Parameters
A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
x >= 110
Number of objects to skip before returning results.
3
Filter by time interval in days (e.g., 30 for last 30 days).
2500
Filter by payment intent ID.
"fpi_01J9XR8M3K7VZ8N2YB4WJ6T0RA"
Filter by checkout session status.
open, paid, complete, canceled, expired "open"
Filter by customer ID.
"fcus_01J9XR8M3K7VZ8N2YB4WJ6T0RA"
Filter results by customer email address.
"john.doe@example.com"
Filter by subscription ID.
"fsub_01J9XR8M3K7VZ8N2YB4WJ6T0RA"
Filter by the client reference ID you provided when creating the checkout session.
"example_value"
If true, expands the customer object in the response.
false
If true, expands the payment intent object in the response.
false
Comma-separated list of related objects to expand in the response.
""
Return sessions created after this timestamp (exclusive). ISO 8601 format.
"2026-06-15T14:30:00Z"
Return sessions created at or after this timestamp (inclusive). ISO 8601 format.
"2026-06-15T14:30:00Z"
Return sessions created before this timestamp (exclusive). ISO 8601 format.
"2026-06-15T14:30:00Z"
Return sessions created at or before this timestamp (inclusive). ISO 8601 format.
"2026-06-15T14:30:00Z"
A cursor for use in pagination. starting_after is a checkout session ID that defines your place in the list. For instance, if you make a list request and receive 20 checkout sessions, ending with fcs_xyz, your subsequent call can include starting_after=fcs_xyz to fetch the next page.
"fcs_01J9XR8M3K7VZ8N2YB4WJ6T0RA"
A cursor for use in pagination. ending_before is a checkout session ID that defines your place in the list. For instance, if you make a list request and receive 20 checkout sessions, starting with fcs_abc, your subsequent call can include ending_before=fcs_abc to fetch the previous page.
"fcs_01J9XR8M3K7VZ8N2YB4WJ6T0RA"
Return only checkout sessions with any associated dispute
false
Response
Success
An envelope wrapping a list of checkout session objects.
The list of checkout sessions.