Get subscription

GET/v1/subscription

Returns the account's single subscription, including its plan, status, trial details, and plan limits. Read this to decide what the account can currently do.

Response fields

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.

status meanings: trialing (in a trial), active (paid and current), past_due (a payment failed), canceled (ended), trial_expired (a cardless trial lapsed without a card). Write actions across the API return 402 unless the account is trialing or active.

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
}