API Documentation
Rate Limits
Rate limits are applied per API key, per minute:
Anonymous (no API key)
Requests without an Authorization header, or with an invalid key, are limited per IP address. These limits apply to all anonymous traffic regardless of plan:
| Endpoint | Limit (per IP) |
|---|---|
| GET /api/generate | 10 / minute |
| GET /api/inbox/:address | 20 / minute |
| GET /api/email/:id | 60 / minute |
| DELETE /api/inbox/:address | 10 / minute |
| POST /api/inbox/:address/extend | 5 / minute |
| GET /api/domains | 60 / minute |
| GET /api/tools/* | 10 / minute |
An IP that generates more than 20 addresses within 10 minutes is automatically blocked for 1 hour.
Authenticated (with API key)
Valid API keys bypass per-IP and per-minute limits. Only your planβs monthly request quota applies:
| Plan | Monthly quota | Per-minute limit | Maximum API keys | Webhooks |
|---|---|---|---|---|
| Free | 1,000 | None | 1 | 0 |
| Starter | 10,000 | None | 2 | 1 |
| Pro | 100,000 | None | 5 | 3 |
| Business | Unlimited | None | Unlimited | 10 |
When a rate limit is exceeded, the API returns 429 Too Many Requests. The response body includes { error, plan, quota, used } when the monthly quota is exhausted.