Get subscription

One subscription with its items, coupons and any scheduled change.

GET https://cotlet.dev/api/v1/chargebee/subscriptions/{subscription_id}

read

Returns the plan item prices with quantities, the coupons on the subscription, the billing dates and whether a change is scheduled. Read it before changing a plan or cancelling, so you know what the call replaces.

Parameters

Parameters: get_subscription
NameTypeDescription
subscription_id string required string Subscription ID from list_subscriptions.

Request

cURL
curl https://cotlet.dev/api/v1/chargebee/subscriptions/subscription_8c41d2 \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("chargebee", "get_subscription", {"subscription_id":"subscription_8c41d2"})
Node.js
const result = await cotlet.call('chargebee', 'get_subscription', {"subscription_id":"subscription_8c41d2"});
CLI
cotlet call chargebee get_subscription --data '{"subscription_id":"subscription_8c41d2"}'

Example response

JSON

{
  "subscription_id": "sub_4d7mTz",
  "customer_id": "cus_4d7mTz",
  "status": "active",
  "items": [
    {
      "item_price_id": "starter-USD-monthly",
      "quantity": 1,
      "unit_price": 9900
    }
  ],
  "coupons": [],
  "has_scheduled_changes": false,
  "current_term_end": "2026-11-01T00:00:00Z",
  "contract_term": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.