Tiers & signup trial
Every Sybilion account is on a pricing tier. Your tier determines how many requests per minute you can make and how many forecast jobs you can run in parallel. Higher tiers are unlocked automatically as you use and pay for the API; the Enterprise tier is assigned by Sybilion under a contract.
You can see your current tier, your next tier (if any), and your live progress in the Developers Portal under Tiers, or by calling GET /api/v1/tiers.
What a tier gives you
Each tier sets three independent limits, all enforced at the API edge:
- Requests per minute for the general API surface (account, usage, jobs, forecasts, catalog).
- Requests per minute for the synchronous billed endpoints (e.g.
POST /api/v1/drivers). - Concurrent forecast jobs — the number of
queuedorrunningasync forecasts you may have at one time.
If you exceed any of these you get 429 Too Many Requests; if you have no balance for a billed call you get 402 Payment Required. See Errors & limits.
Tier names
| Tier | Who it's for |
|---|---|
| Free | New accounts trying the API on the signup trial credit. |
| Starter | Active developers who have made at least one paid top-up. |
| Pro | Teams running steady production workloads. |
| Growth | High-volume integrations. |
| Enterprise | Contracted customers with custom limits, SLAs, and support. Assigned by Sybilion. |
The exact thresholds and per-tier limits in effect for your account are returned by GET /api/v1/tiers — that endpoint is the source of truth and may evolve over time.
Moving up
For Free → Starter → Pro → Growth: top up your balance from the Developers Portal Billing page. Promotions are automatic and take effect immediately on the next request.
For Enterprise: contact [email protected] with a brief description of your use case and expected volume. We tailor limits, SLAs, and onboarding to your contract.
Signup trial credit
New accounts receive a one-time trial credit on their first authenticated request, which is enough to try every endpoint, including the async forecast pipeline. The credit:
- Is granted once per account and survives retries (idempotent).
- Has an expiry date — anything unspent by then drops to zero. The exact validity window is returned in your account record.
- Will not be granted again to accounts that have already topped up.
You can see the trial state — granted amount, remaining balance, expiry date — in the signup_trial block on GET /api/v1/me.
Where the live numbers come from
Anything that depends on your account state — your tier, your remaining trial balance, your concurrency budget, the credit balance left in each grant — is exposed by the API:
GET /api/v1/me— balances, tier, trial state, active credit grants.GET /api/v1/tiers— your tier ladder and progress to the next tier.GET /api/v1/usage— paginated usage events.
Treat those endpoints (and the matching pages in the Developers Portal) as canonical; they reflect the configuration in production.