Rate Limits

MisarMail enforces rate limits at two levels: per-API-key request rate, and per-plan send volume.

Request Rate Limits

Plan	Requests per Minute
Free	30 req/min
Pro	120 req/min
Max	500 req/min
Enterprise	Custom

When a rate limit is exceeded, the API returns:

{
  "success": false,
  "error": "Too many requests. Slow down."
}

HTTP status: 429 Too Many Requests

Email Send Volume

Send volume is enforced per plan, tracked daily and monthly.

Plan	Daily Limit	Monthly Limit
Free	500	15,000
Pro	10,000	300,000
Max	50,000	1,500,000
Enterprise	Custom	Custom

When the daily or monthly limit is reached:

{
  "success": false,
  "error": "Daily send limit reached. Upgrade at mail.misar.io/pricing"
}

HTTP status: 429 Too Many Requests

Checking Your Usage

Check current usage in Settings → Usage or call:

GET https://mail.misar.io/api/v1/analytics
Authorization: Bearer msk_your_key

Retry Strategy

For 429 responses, implement exponential backoff:

async function sendWithRetry(payload, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const res  = await fetch("https://mail.misar.io/api/v1/send", {
      method:  "POST",
      headers: { "Authorization": `Bearer ${process.env.MISARMAIL_API_KEY}`, "Content-Type": "application/json" },
      body:    JSON.stringify(payload),
    });
    const data = await res.json();

    if (res.status === 202) return data;          // queued — stop
    if (res.ok)             return data;          // success — stop
    if (res.status >= 400 && res.status < 500) {
      throw new Error(data.error || `HTTP ${res.status}`); // 4xx — don't retry
    }
    if (attempt < maxRetries - 1) {
      await new Promise(r => setTimeout(r, 1000 * Math.pow(2, attempt)));
    }
  }
  throw new Error("Max retries exceeded");
}

Upgrading Your Plan

If you regularly hit limits, upgrade your plan for higher quotas. Enterprise plans include custom limits and dedicated SMTP pools.