Skip to main content
GET
List subscriptions

Authorizations

Authorization
string
header
required

Bearer token authentication. Pass your API key as Authorization: Bearer sk_.... See Authentication for keys, scopes, and sandbox vs production.

Query Parameters

limit
integer
default:50
Required range: 1 <= x <= 100
offset
integer
default:0
Required range: x >= 0
customer_id
string

Only subscriptions for this customer (cust_...).

status
enum<string>

Only subscriptions in this status.

Available options:
trialing,
active,
past_due,
unpaid,
canceled

Response

A page of subscriptions

items
object[]

The subscriptions on this page, newest first. Each entry is a Subscription with the same shape the retrieve endpoint returns.

pagination
object

Where this page sits in the full result set, so you know the applied limit and offset, how many rows matched, and whether another page exists.