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

PlanRequests per secondEvents per month
Free1010,000
Pro1001,000,000
Scale50020,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.