DocumentationRate Limits & Plan Limits
5 min

Rate Limits & Plan Limits

Learn how API requests and MCP access are limited by plan and how to make the most of your limits.

API Rate Limits

Each API request is checked against a per-minute limit. The limit depends on your plan. When exceeded, you receive a 429 response with a Retry-After header.

1

Free plan: 60 requests/minute (API access requires Pro or higher).

2

Starter plan: 300 requests/minute (API access requires Pro or higher).

3

Pro plan: 1,000 requests/minute – API access included.

4

Business plan: 3,000 requests/minute – API access included.

Rate Limit Headers

Every API response includes rate limit headers: X-RateLimit-Limit (your limit), X-RateLimit-Remaining (remaining requests), and X-RateLimit-Reset (Unix timestamp for reset). Use these headers to intelligently throttle your application.

Tip

Implement exponential backoff on 429 responses: Wait the time specified in the retryAfter field before retrying. This avoids unnecessary failed attempts.

Plan Restrictions

API access (REST API and MCP Server) is available from the Pro plan. Free and Starter plans receive a 403 error with an upgrade hint on API calls. MCP Server access shares the same rate limit as the REST API.

Rate Limits & Plan Limits – Mailaura Docs | Mailaura