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:

EndpointLimit (per IP)
GET /api/generate10 / minute
GET /api/inbox/:address20 / minute
GET /api/email/:id60 / minute
DELETE /api/inbox/:address10 / minute
POST /api/inbox/:address/extend5 / minute
GET /api/domains60 / 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:

PlanMonthly quotaPer-minute limitMaximum API keysWebhooks
Free 1,000 None10
Starter 10,000 None21
Pro 100,000 None53
Business UnlimitedNoneUnlimited10

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.