List Subscriptions
Subscriptions
List Subscriptions
Retrieve a paginated list of client subscriptions for your tenant, with optional filters for client and status.
GET
List Subscriptions
This endpoint requires a PRO plan or above. If your plan does not include the External Billing API, the request returns
403 with error code external_billing_api.Combining filters
All query parameters are optional and can be used together or individually:Subscription statuses
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Filter subscriptions for a specific client. Accepts a plain integer ID or a base64 GraphQL global ID. Omit to return all clients under the tenant.
Example:
"Q2xpZW50OjEyMw=="
Filter by subscription status.
Available options:
active, past_due, blocked, canceled Example:
"active"
Page number. Default: 1.
Example:
1
Results per page. Default: 20. Maximum: 100.
Required range:
x <= 100Example:
20

