List subscriptions
Paginated subscriptions for your account, newest first. The status counters cover recurring subscriptions only — one-time purchases appear in `results` but are excluded from the totals.
Authorization
ApiKey API key issued to the partner, sent with the Bearer prefix — for example: Authorization: Bearer sk_live_abc123.
In: header
Query Parameters
A page number within the paginated result set.
Number of results to return per page.
Filter the list to one subscription status, for example active or pending_cancellation. Omit it to get every status. Added in API 1.0.2.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/subscriptions/"{ "count": 90, "next": "https://api.suqo.ai/api/v1/subscriptions?page=2", "previous": null, "total_subscriptions": 85, "active_subscriptions": 60, "due_subscriptions": 10, "inactive_subscriptions": 15, "results": [ { "subscription_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "status": "active", "is_active": true, "client": { "phone": "9800000001", "full_name": "John Doe", "email": "[email protected]", "address": "Kathmandu, Nepal", "billing": { "business_name": "ABC Pvt Ltd.", "email": "[email protected]", "address": "Kathmandu, Nepal", "pan_vat": "111111111" }, "shipping": { "phone": "9800000001", "full_name": "John Doe", "email": "[email protected]", "address": "Kathmandu, Nepal" } }, "product": { "product_id": "205293a1-84f4-426e-8f8c-5ddb239e5d2f", "name": "Pro Plan Bundle", "plan_name": "Basic", "pbp_id": "pbp_3n9k2x", "label": "Monthly", "price": "999.00", "currency": "NPR" }, "current_period_start": "2026-07-03T00:00:00Z", "current_period_end": "2026-08-03T00:00:00Z", "next_billing_cycle": "2026-08-03T00:00:00Z", "created_at": "2026-07-03T10:15:00Z" } ]}List products GET
Paginated active products of your account, newest first, each with its plans and visible billing periods. Use a billing period's `pbp_id` to create a subscription.
Create a subscription POST
Create a subscription for a client against one of your billing periods. The subscription starts in `pending_checkout`; send the returned `checkout_url` to the client to collect payment.