List subscriptions
Subscriptions filtered by customer, status, plan or renewal date, newest first.
GET https://cotlet.dev/api/v1/chargebee/subscriptions
read
Returns subscriptions with status, plan, quantity and next billing date, newest first. Status is one of future, in_trial, active, non_renewing, paused or cancelled. Use it to find who is on a plan or whose subscription renews soon. Pages hold up to 100 subscriptions; pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| customer_id string | string | Only this customer's subscriptions. |
| status enum | enum | future, in_trial, active, non_renewing, paused or cancelled. |
| item_price_id string | string | Only subscriptions on this plan price, for example growth-USD-monthly. |
| next_billing_before datetime | datetime | Only subscriptions renewing before this time. |
| limit integer | integer | 1 to 100. Default: 10. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/chargebee/subscriptions \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("chargebee", "list_subscriptions")const result = await cotlet.call('chargebee', 'list_subscriptions');cotlet call chargebee list_subscriptionsExample response
{
"subscriptions": [
{
"subscription_id": "sub_9s2kQw",
"customer_id": "cus_9s2kQw",
"status": "active",
"item_price_id": "growth-USD-monthly",
"quantity": 1,
"next_billing_at": "2026-11-01T00:00:00Z",
"has_scheduled_changes": false
}
],
"next_cursor": null
}