Rate Limits
S2S API Rate Limits
| Tier | Limit | Batch Size |
|---|---|---|
| Free | 100 requests/minute | Up to 100 events per batch |
| Pro | 1,000 requests/minute | Up to 100 events per batch |
| Enterprise | Custom | Custom |
Rate Limit Headers
Every API response includes rate limit information:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 997
X-RateLimit-Reset: 1679616000
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests per window |
X-RateLimit-Remaining | Remaining requests in current window |
X-RateLimit-Reset | Unix timestamp when the window resets |
SDK Batching (Client-Side)
The client SDK manages its own batching to optimize network usage:
| Setting | Default | Description |
|---|---|---|
BatchMaxEvents | 100 | Max events per batch |
BatchSizeBytes | 65,536 (64 KB) | Max batch size in bytes |
FlushIntervalMs | 30,000 (30s) | Time-based flush interval |
These settings keep client-side traffic well within API rate limits under normal usage.