API Reference / Account & billing
Account & billing
Read and manage your subscription, plans, usage, and invoices. Prices are always in cents, and a limit of -1 means unlimited. Most reads need account:read; changes need billing:write or billing:cancel.
The subscription object
id
string
Prefixed identifier, e.g. sub_3ZLn….
plan_id
string
Current plan: standard, premium, or enterprise.
plan_name
string
Display name of the plan, e.g. Standard.
price
integer
Monthly price in cents (1900 = $19). 0 for enterprise.
status
string
trialing, active, past_due, canceled, or trial_expired.
trial_ends_at
timestamp | null
When the trial ends, or null when not on a trial.
trial_type
string | null
cardless (no card yet) or carded (card on file).
current_period_end
timestamp | null
When the current billing period ends.
cancel_at_period_end
boolean
Always false. Cancellation is immediate, not deferred.
flows_limit
integer
Flows allowed on this plan. -1 means unlimited.
conversions_limit
integer
Monthly conversions allowed. -1 means unlimited.
Endpoints
GET/v1/subscriptionGet the current plan, trial state, and limits.POST/v1/subscriptionStart a paid subscription once a card is attached.PATCH/v1/subscriptionChange the plan. Requires billing:write.POST/v1/subscription/cancelCancel immediately. Requires billing:cancel.GET/v1/plansList the available plans, prices, and limits.GET/v1/usageCurrent usage against your plan limits.GET/v1/invoicesList invoices with hosted and PDF links.GET/v1/billing/setup-intentsCreate a setup intent to collect a card.
GET/v1/subscription
curl https://app.converly.io/api/v1/subscription \ -H "Authorization: Bearer sk_live_…"
200 OK
{
"id": "sub_3ZLn…",
"plan_id": "standard",
"plan_name": "Standard",
"price": 1900,
"status": "trialing",
"trial_ends_at": "2026-07-14T21:35:41.000Z",
"trial_type": "cardless",
"current_period_end": "2026-07-14T21:35:41.000Z",
"flows_limit": 1,
"conversions_limit": 100
}