Skip to main content
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

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

client_id
string

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=="

status
enum<string>

Filter by subscription status.

Available options:
active,
past_due,
blocked,
canceled
Example:

"active"

page
integer
default:1

Page number. Default: 1.

Example:

1

page_size
integer
default:20

Results per page. Default: 20. Maximum: 100.

Required range: x <= 100
Example:

20

Response

Subscriptions returned successfully.

data
object[]
meta
object