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

Get Usage

This month's usage next to the organization's plan limits.

GET/v1/billing/usageTry it
Session token

Returns an organization's usage this calendar month next to its plan limits — the numbers behind 402 USAGE_LIMIT_EXCEEDED (see Monthly Usage Limits).

Note

Requires a session JWT for any member of the organization. API keys are not accepted on billing endpoints. A non-member gets 403 forbidden ("Not a member of this organization"). Any plan.

Query Parameters

NameDescription
orgId:stringqueryRequired
The organization ID (a UUID). Missing or malformed, the request returns 400.

Response

NameDescription
usage.builds:number
Builds this calendar month.
usage.ai_queries:number
AI assistant queries this calendar month.
usage.pages:number
Pages recorded this calendar month.
usage.projects:number
Projects the organization has now, not counting deleted ones. This is a current count, not a monthly total, and it is what the limits.projects cap applies to.
limits:object
The plan's limits. -1 means unlimited. An organization without a subscription gets the Free limits shown above.
tier:string
free, starter, pro, or enterprise.

Errors

StatusCodeWhen
400validation_errororgId is missing or isn't a UUID
401unauthorizedNo session token, an invalid or expired one, or an API key
403forbiddenYou're not a member of the organization
Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl "https://api.syntext.dev/v1/billing/usage?orgId=$ORG_ID" \
-H "Authorization: Bearer $SYNTEXT_JWT"
Responseapplication/json
json
{
"data": {
"usage": { "pages": 12, "builds": 37, "ai_queries": 140, "projects": 1 },
"limits": { "projects": 1, "pages": 50, "buildsPerMonth": 100, "aiQueries": 200, "members": 2 },
"tier": "free"
}
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext