Subscriptions

Cancel Subscription

Cancel a subscription by setting endTimestamp and status to 'canceled'. Soft-deletes associated subscription details and features, and expires active credit grants linked to the plan. The subscription record is retained for historical purposes.

DELETE
/subscriptions/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

Use your secret API key as the bearer token

In: header

Path Parameters

id*string

Subscription stable ID (sub_stable_*)

Response Body

application/json

application/json

application/json

curl -X DELETE "https://api.getlumen.dev/v1/subscriptions/sub_stable_abc123"
{
  "success": true,
  "message": "Subscription, associated features, details, and credit grants expired successfully"
}
{
  "error": "Subscription not found or already ended"
}
{
  "error": "Failed to cancel subscription"
}