Skip to main content

monthly_quota_exceeded

Your plan's allowance for this billing period is used up. Nothing was sent and nothing was charged.

Status: 402, with no Retry-After, because there is no short wait that fixes it.

{
  "status": 402,
  "type": "monthly_quota_exceeded",
  "message": "Monthly send quota exceeded. Upgrade your plan to continue sending.",
  "request_id": "req_01J8K2P...",
  "doc_url": "https://docs.epostix.com/errors/monthly_quota_exceeded"
}

The contact endpoints use the same type when a workspace is at its audience limit, with the message Contact limit exceeded. Upgrade your plan to add more contacts.

Why you got this​

  • The period's send allowance is spent.
  • Every recipient counts, so to, cc and bcc all draw on it.
  • On the contacts endpoints, the workspace is at its maximum audience size.

How to fix it​

Change the plan, or wait for the billing period to roll over. Unlike a daily quota, this one does not clear overnight.

If the volume was unexpected, the send history will show where it went. A retry loop against an unreachable address, or a bulk job that ran twice, are the usual causes.

Is it safe to retry​

Not usefully. The same request will fail until the plan changes or the period resets. Stop the sender rather than looping, and surface the condition where someone will see it.