v12

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-014994227.2 KB

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

$schemastring uri

A URL to the JSON Schema for this object.

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.

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.

Example response

{
  "$schema": "/api/v1/SubscriptionResponse.json"
}