Sign in
Subscriptions

Query subscriptions

Use when listing or searching subscriptions (e.g. admin view or customer subscription list). Returns a paginated list; supports filtering by customer, plan, status.

post/subscriptions/search

Request body

active_atstring

ActiveAt filters subscriptions that are active at the given time

billing_cadenceTypesBillingCadence[]

BillingCadence filters by billing cadence

billing_periodTypesBillingPeriod[]

BillingPeriod filters by billing period

customer_idstring

CustomerID filters by customer ID

end_timestring
expandstring
external_customer_idstring

ExternalCustomerID filters by external customer ID

invoicing_customer_idsstring[]

InvoicingCustomerIDs filters by invoicing customer ID

limitinteger
offsetinteger
order'asc' | 'desc'
parent_subscription_idsstring[]

ParentSubscriptionIDs filters by parent subscription IDs

plan_idstring

PlanID filters by plan ID

start_timestring
status'published' | 'deleted' | 'archived'
subscription_idsstring[]
subscription_statusTypesSubscriptionStatus[]

SubscriptionStatus filters by subscription status

with_line_itemsboolean

WithLineItems includes line items in the response

Response

OK

Changes