Sample documentation page (fictional product, used by the DocsChat demo)
Rate limits
The Nimbus API limits how many requests you can make so the platform stays fast for everyone.
Default limits
| Plan | Requests per second | Events per month |
|---|---|---|
| Free | 10 | 10,000 |
| Pro | 100 | 1,000,000 |
| Scale | 500 | 20,000,000 |
Test mode requests have their own limit of 5 requests per second and do not count toward the monthly event quota.
What happens when you exceed a limit
The API responds with 429 Too Many Requests and a Retry-After header telling you how many seconds to wait. Every response also includes X-RateLimit-Limit and X-RateLimit-Remaining.
Handling 429 responses
Wait for the number of seconds in Retry-After, then retry. For bulk sends, use the batch endpoint POST /v1/events/batch, which accepts up to 100 events per request and counts as a single request against the per-second limit.