Usage & billing
How usage is measured, and how plans and limits work.
Usage
Accepts an optional from/to range (defaults to the trailing 30 days, capped at 366 days) and returns totals for the full range plus a paginated daily breakdown:
curl "https://api.nexus.chaitanya-bajpai.xyz/organizations/org_123/usage" \
-H "Cookie: raas_session=..."
estimatedCost is exactly that — an illustrative estimate based on published provider pricing, not a billing statement. It's computed the same way the dashboard's own usage chart displays it.
Limits
Every organization has a daily document-processing quota and a daily embedding-token budget, checked before the request that would consume them (document completion, and every embedding call — both the per-query embedding in chat and the bulk embedding in ingestion) — never after the fact. Chat is additionally rate-limited per organization and per user, requests per minute, independent of the daily token budget. Hitting a limit returns a normal error response with a code identifying which one, not a silent drop.
Plans
Nexus has three self-serve tiers — Starter, Pro, and Advanced — billed monthly or yearly, with country-localized pricing shown at checkout. Current pricing is always accurate on the pricing page itself rather than duplicated here, so this doc can't go stale relative to what you'd actually be charged.
Billing runs through Paddle as Merchant of Record. Plan changes are driven by Paddle webhooks — your organization's plan updates automatically once a subscription event is verified, typically within seconds of checkout completing.