List Subscriptions
Returns a paginated list of an account’s subscriptions.
merchant_reference is not a filter on this endpointSending it has no effect: the parameter is ignored and the full, unfiltered page is returned. To look a subscription up by merchant reference, keep the id you received when you created it, or page through this endpoint and match client-side.Scope and ordering
The list is always scoped to the single account in theX-Account-Code header — there is no cross-account variant. Results are ordered by created_at descending, so a subscription created while you page can shift items across page boundaries. For a stable sweep, filter with created_at_to fixed at the moment you started.
Filters are combinable and all optional; each one narrows the result set further. With none set, subscriptions in every status are returned, including CANCELED and COMPLETED ones.Authorizations
Headers
The account_id found in your Yuno Dashboard (UUID). Required — the list is always scoped to a single account. Omitting it returns 400 INVALID_PARAMETERS ("x-account-code header is required.").
Query Parameters
Filter by status. Accepts several values separated by commas, matching any of them — ACTIVE,PAUSED. Values must be spelled exactly as in Subscription statuses; an unknown one returns 400 BAD_REQUEST ("Invalid status: FOO.").
"ACTIVE,PAUSED"
Filter by the plan the subscription is linked to (UUID). A plan with no subscribers — or one that doesn't exist — returns an empty list, not an error. A value that isn't a UUID returns 400 BAD_REQUEST ("Invalid plan_id.").
"00000000-0000-4000-8000-000000000001"