Skip to main content
GET
List checkout sessions

Authorizations

Authorization
string
header
required

Your project secret key: sk_test_... (testnet) or sk_live_... (mainnet). Use it only on your server.

Query Parameters

status
enum<string>

Only return sessions with this status. pending: waiting for payment. processing: a transaction was submitted and is being verified. completed: payment verified. failed: verification failed. expired: no payment within 30 minutes.

Available options:
pending,
processing,
completed,
failed,
expired
limit
integer
default:20

Number of sessions to return (1-100).

Required range: 1 <= x <= 100
starting_after
string

Cursor for pagination: the id of the last session from the previous page.

Response

A page of sessions

object
enum<string>
Available options:
list
data
object[]
has_more
boolean