Skip to main content
POST /v1/billing/cancel
Cancels your active subscription. The cancellation takes effect at the end of the current billing period — you retain full access until then. After the period ends, your account downgrades to the Developer (free) plan.

​
Response

Returns the updated subscription object with cancel_at_period_end set to true.
​
status
string
Subscription status. Remains active until the period ends, then changes to canceled.
​
plan_key
string
The current plan identifier (e.g., plan_starter, plan_business).
​
current_period_end
string
ISO 8601 timestamp for when the current billing period ends and the cancellation takes effect.
​
cancel_at_period_end
boolean
true after a successful cancellation request.
curl -X POST https://api.truthlocks.com/v1/billing/cancel \
  -H "X-API-Key: tl_live_..."

{
  "status": "active",
  "plan_key": "plan_starter",
  "current_period_end": "2026-05-01T00:00:00Z",
  "cancel_at_period_end": true
}
Cancellation is immediate but takes effect at the end of your billing period. You cannot undo a cancellation via the API — to resubscribe, create a new checkout session.