List subscriptions
Subscriptions with plan, state, quantity, price and renewal dates.
GET https://cotlet.dev/api/v1/recurly/subscriptions
read
Lists subscriptions, 50 per page by default and up to 200. Filter by state; past_due returns active or canceled subscriptions that have an overdue invoice. Each item has the subscription_id for the write tools, the plan code, the unit amount in cents and the current period end.
Parameters
| Name | Type | Description |
|---|---|---|
| state enum | enum | active, canceled, expired, future, in_trial, live or past_due. Default: all. |
| per_page integer | integer | 1 to 200. Default: 50. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl "https://cotlet.dev/api/v1/recurly/subscriptions?state=past_due&per_page=50" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("recurly", "list_subscriptions", {"state":"past_due","per_page":50})const result = await cotlet.call('recurly', 'list_subscriptions', {"state":"past_due","per_page":50});cotlet call recurly list_subscriptions --data '{"state":"past_due","per_page":50}'Example response
{
"subscriptions": [
{
"subscription_id": "44f83d0cbf86d2b8a5b3d3e6c3e8b16f",
"account_code": "acme-co",
"plan_code": "team",
"state": "active",
"quantity": 1,
"unit_amount_in_cents": 24000,
"currency": "USD",
"current_period_ends_at": "2026-11-14T00:00:00Z"
}
],
"total": 1,
"next_cursor": null
}