List subscriptions
Retrieve existing subscriptions. By default, draft, voided, cancelled and archived subscriptions are not included (status=all applies the same exclusion) — pass status=any to list every status, or status__in=active,cancelled to pick the ones you need.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
0 <= x <= 100x >= 0checkout, contract_start_date, quote, start_date, manually checkout, contract_start_date, quote, start_date, manually Subscription status filter.
active,pending,paused,errored,cancelled,draft,voided,archived: match that status.inactive: shortcut forpending+paused.all: every status exceptdraft,voided,cancelledandarchived— the same exclusion as omitting the filter.any: every status, no exclusion.
Use status__in with comma-separated values to combine statuses. When the filter is omitted, draft, voided, cancelled and archived subscriptions are excluded.
all, any, inactive, active, errored, cancelled, paused, pending, draft, voided, archived Comma-separated list of subscription statuses to include. Same values as status.
all, any, inactive, active, errored, cancelled, paused, pending, draft, voided, archived Return only subscriptions whose active contract starts on or after this date.
"2026-01-01T00:00:00.000Z"
Return only subscriptions whose active contract starts on or before this date.
"2026-12-31T23:59:59.999Z"
Return only subscriptions whose active contract ends on or after this date.
"2026-10-01T00:00:00.000Z"
Return only subscriptions whose active contract ends on or before this date.
"2026-12-31T23:59:59.999Z"
Return only subscriptions whose active contract renews automatically (true) or not (false).
true

