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.
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"
}