Rate Limits
Altermail enforces two layers of rate limiting to protect service stability and prevent abuse. These limits apply in addition to your plan's email quota.
| Limit | Keyed by | Scope | Window | Response |
|---|---|---|---|---|
200 req | IP address | All endpoints (global) | 15 minutes | 429 |
60 sends | API token | Send endpoint only | 1 minute | 429 |
Important
The global limit is keyed by IP address; if you share infrastructure (e.g. multiple services behind one NAT), all traffic from that IP counts toward the same limit. The send limit is keyed by your API token, so it applies per account regardless of where the request originates. Both limits must be satisfied. Build retry logic with exponential back-off when you receive a429.// 429 response, global limit (200 req / 15 min, per IP)
{ "message": "Too many requests, please slow down." }
// 429 response, send endpoint token limit (60 sends / min, per account)
{ "message": "Too many send requests for this account. Please wait before sending again." }