Sign in
Billing

Get current plan

Returns the caller organization's active subscription plan. Only an active subscription is returned; if the org has none, this responds 404. (The status field is therefore always 'active' here.)

get/billing/subscription

Response

OK

balance_displaystring required

Formatted balance string (e.g., '$12.50').

balance_microdollarsinteger required

Current account balance in microdollars.

billing_cycle'monthly' | 'yearly' required

Billing frequency for this subscription.

cancel_at_period_endboolean required

Whether the subscription cancels at the end of the period.

canceled_atstring date-time

Timestamp when the subscription was canceled.

current_period_endstring date-time required

End of the current billing period.

current_period_startstring date-time required

Start of the current billing period.

idstring uuid required

Subscription identifier.

included_balance_displaystring required

Formatted included balance (e.g., '$10.00').

included_balance_microdollarsinteger required

Balance granted each billing period in microdollars.

max_concurrent_runsinteger required

Maximum simultaneous runs allowed on this plan.

monthly_pricenumber double required

Monthly plan price in dollars.

pending_downgrade_effective_datestring date-time

When the pending downgrade takes effect.

pending_downgrade_plan_idstring

Plan ID of a scheduled future downgrade.

plan_idstring uuid required

Billing plan's identifier.

plan_namestring required

Customer-facing plan name (Hobby, Pro, Scale, Enterprise).

price_per_second_microdollarsinteger required

Per-second compute charge in microdollars.

status'active' | 'canceled' | 'past_due' | 'trialing' | 'incomplete' | 'incomplete_expired' | 'unpaid' required

Current lifecycle state of the subscription.

trial_endstring date-time

Timestamp when the free trial ends.

yearly_pricenumber double required

Annual plan price in dollars.

Changes