Get a list of subscriptions
Retrieves a paginated list of subscriptions, with optional filters for customer, status, and plan.
Query parameters
Return items that come after this cursor
Return items that come before this cursor
Maximum number of items to return
Filter by customer ID
Filter by subscription status. Supports comma-separated values for multiple statuses
Filter by plan ID
Filter by resource ID
Filter by pricing type. Supports comma-separated values for multiple types
Filter by creation date using range operators: gt, gte, lt, lte
Headers
Account ID — optional when authenticating with a user JWT (Bearer token); falls back to the user's first membership. Ignored for API-key auth.
Environment ID — required when authenticating with a user JWT (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is intrinsic to the key).
Response
A paginated list of subscription objects.