Skip to main content
GET
Current billing cycle summary (tier, included credit, used, overage, status)

Authorizations

Authorization
string
header
required

Session access JWT or an API token (insta_<prefix>_<secret>).

Path Parameters

orgId
string<uuid>
required

Response

Default Response

tier
enum<string>
Available options:
free,
pro,
team,
enterprise
billingStatus
enum<string>
Available options:
active,
suspended
cycleStart
string<date-time>
cycleEnd
string<date-time>
includedUsd
number

tier allowance for the cycle (free $5 / pro $20 / team $0 — the plan fee is flat and usage bills from the first cent / enterprise per deal, $0 default); platform-configurable

usedUsd
number
overageUsd
number
status
enum<string>
Available options:
active,
suspended
subscriptionStatus
string | null

Stripe subscription status (active/past_due/canceled/…); null if no paid subscription.

caps
object

this plan's resource ceilings for a compute service (vCPU / MB / volume Gi; managed redis/mysql/mongodb read the compute row) and for a postgres service (millicores / MiB / volume Gi) — the same rows the per-service cap fields return. A NEW service is born at them (cpu, memory and, since 2026-09-12, its volume), and an existing one may be raised to them. Read them from here to prefill a create form before any service exists; they move with the plan and with env overrides per deployment, so never hardcode a tier's numbers.