Response headers
Every 2xx response includes:Remaining is how many more requests fit in the current minute
window.
429 responses
Retry-After is seconds until the next minute boundary. A
well-behaved client sleeps for that duration and retries.
Our SDKs do this automatically:
- Python: up to 3 automatic retries on 429, respecting
Retry-After. - TypeScript: same behavior.
- Override with
retry_on_429=Falseif you’d rather handle it yourself.
Fixed-window burst
The algorithm is a per-minute fixed-window counter — not a rolling window. At the minute boundary, 2× the limit can pass in a single second: the last second of minute A + the first second of minute B. For most customers this doesn’t matter. If you need strict smoothing, implement a client-side token bucket on top.Tier options
| Tier | rate_limit_per_min | Typical use |
|---|---|---|
| Free / trial | 60 | Development, small-scale testing |
| Paid default | 600 | Production CRM sync, warehouse pipelines |
| Enterprise | 6,000 | High-volume campaigns, real-time dashboards |