/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference Get Subscription

Get Subscription

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").

Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl "https://api.syntext.dev/v1/billing/subscription?orgId=0b6f2c1e-8a4d-4f3b-9c2e-7d1a5e6f8b90" \
-H "Authorization: Bearer $SYNTEXT_JWT"
Responseapplication/json
200jsonOK
{
"data": {
"tier": "pro",
"interval": "monthly",
"currentPeriodEnd": "2026-12-01T00:00:00.000Z",
"cancelAtPeriodEnd": false,
"limits": { "projects": 25, "pages": 5000, "buildsPerMonth": 1000, "aiQueries": 5000, "members": 20 }
}
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext