Get an organization's plan, billing interval and plan limits
GET/v1/billing/subscriptionTry it
Session token
Returns an organization's plan tier, billing interval, renewal date and plan limits. For this month's usage against those limits, see Get Usage. The card on file is not included — use Get Payment Method.
Note
Requires a session JWT. Any member of the organization can call it (member, admin or owner). API keys are not accepted on billing endpoints. Any plan.
Query Parameters
NameDescription
orgId:stringqueryRequired
The organization ID (a UUID).
Response
NameDescription
data.tier:string
One of free, starter, pro or enterprise.
data.interval:string | null
monthly or yearly. Absent for an organization that has never subscribed.
data.currentPeriodEnd:string | null
ISO 8601 end of the current billing period. Absent for an organization that has never subscribed.
data.cancelAtPeriodEnd:boolean
true when the subscription is set to end at currentPeriodEnd. Absent for an organization that has never subscribed.
data.limits:object
The plan's limits: projects, pages, buildsPerMonth, aiQueries and members. -1 means unlimited.
Response — 200 OK
An organization that has never subscribed gets the Free tier and limits only:
Error Responses
400 Bad Request
Returned when orgId is missing or isn't a UUID (validation_error, with the field in details).
401 Unauthorized
Returned when the Authorization header is missing, or the token is invalid or expired.
403 Forbidden
Returned when you are not a member of the organization (forbidden, "Not a member of this organization").