API ReferenceOverview
Rate limits
How many requests you can make, and how to handle 429 responses.
Rate limits protect the API from bursts that would slow down everyone. They apply per account and per mode.
| Plan | Send events | Other requests |
|---|---|---|
| Free | 50 / second | 25 / second |
| Pro | 500 / second | 100 / second |
| Scale | Custom | 250 / second |
Headers
Every response tells you where you stand:
RateLimit-Limit: 500
RateLimit-Remaining: 487
RateLimit-Reset: 1Handling 429
When you go over the limit, the API responds with 429 Too Many Requests and a Retry-After header in seconds. The SDKs wait and retry automatically (up to maxRetries).
Sending a large backlog? Use batch sending: one request can carry up to 100 events and counts as one request.