Skip to main content
GET /v1/billing/subscription
Returns the active subscription for your tenant, including the current plan, billing status, and period end date.

​
Response

​
status
string
Subscription status: active, past_due, canceled, or trialing.
​
plan_key
string
The active plan identifier (e.g., plan_starter, plan_business).
​
current_period_end
string
ISO 8601 timestamp for when the current billing period ends.
​
cancel_at_period_end
boolean
Whether the subscription is set to cancel at the end of the current period.
curl https://api.truthlocks.com/v1/billing/subscription \
  -H "X-API-Key: tl_live_..."

{
  "status": "active",
  "plan_key": "plan_starter",
  "current_period_end": "2026-04-28T00:00:00Z",
  "cancel_at_period_end": false
}
To see detailed usage counters for the current billing cycle, use the usage endpoint.