Getting started
Rate Limits
Understand delivery and API rate limits for your account tier.
Delivery limits
| Tier | Rate | Lifetime cap |
|---|---|---|
| Free | 1 delivery per 24 hours | 500 total deliveries |
| Paid | No delivery rate limit | Unlimited |
Once you exhaust your free-tier deliveries, upgrade to a paid plan in the Dashboard to continue sending.
API rate limits
All API endpoints are limited to 100 requests per minute per API key. This applies to both free and paid tiers.
Response headers
Every API response includes rate limit headers so you can track your usage:
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests allowed per window (100). |
X-RateLimit-Remaining | Requests remaining in current window. |
X-RateLimit-Reset | Unix timestamp when the window resets. |
Example headers
HTTP/1.1 200 OK
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1713264120Rate limit exceeded
When you exceed the rate limit, the API returns a 429 Too Many Requests response:
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1713264120
Retry-After: 42
{
"error": {
"code": "rate_limited",
"message": "Too many requests. Please wait 42 seconds before retrying.",
"details": {
"retry_after": 42
}
}
}Use the Retry-After header to determine how long to wait before your next request.