List subscriptions
Subscriptions filtered by customer, status, plan or renewal date, newest first.
MCP tool chargebee_read → list_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. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "chargebee_read",
"arguments": {
"operation": "list_subscriptions",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"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
},
"isError": false
}