callmine.

What happens when I hit my quota?

Billing·May 31, 2026·2 min·By Callmine Team

Quota exhaustion returns HTTP 402. Existing reports stay accessible. Three options: upgrade plan, buy a 100-call add-on, or wait for monthly reset.

TL;DR

Once your workspace exhausts its plan quota for the month, new analyses are blocked. The API returns HTTP 402 with the upgrade options. Existing reports stay accessible. Three paths forward: upgrade the plan, buy a 100-call add-on, or wait for the next monthly reset.

What still works

Hitting quota only blocks new analyses. Everything else continues:

  • ·Existing reports. Open, read, download as PDF, DOCX, or JSON.
  • ·Dashboards. All historical insights stay visible.
  • ·Schedules. Stay in place. New firings are skipped with a quota-exceeded entry in the execution history; the schedule resumes once quota is available.
  • ·Settings. Integrations stay connected, member management works, audit log is readable.

What's blocked is the Run button at /new, the Preview-to-Run path, and any API call that would consume quota.

Three paths forward

Path 1 — buy an add-on pack

$10 for 100 calls, one-time. Add-on calls land in your balance immediately and roll over forever. Best when you have a one-off heavy month. See How do call add-on packs work?.

Path 2 — upgrade the plan

Best when your monthly consumption consistently exceeds the current plan. The new quota is live immediately, your next monthly reset shifts to the new plan's allowance. See How do I upgrade, and what happens to my trial?.

Path 3 — wait for the monthly reset

Free if you can wait. Monthly quota resets at your billing anchor date — visible on /settings → Billing. The block lifts automatically at reset; no action needed.

What the API returns

A blocked request returns HTTP 402 with a JSON body containing:

  • ·A reason field — usually quota_exceeded.
  • ·An upgrade_options array — plans you could upgrade to and the monthly call counts they unlock.
  • ·An addon_available boolean — whether the add-on pack is available to your workspace.

Handle 402 in any tool calling Callmine's API — it's the canonical "need to pay" semantic, and the body tells you the exact next step.

§ Common questions

Frequently asked.

Does hitting quota break anything?

No. Existing reports, dashboards, schedules, and the audit log all stay accessible. Only new analysis submissions are blocked. The block lifts the moment you upgrade, buy an add-on, or your monthly quota resets.

What about scheduled runs — do they fail when quota is exhausted?

Quota-exceeded scheduled runs are skipped with an entry in the schedule's execution history. The schedule itself stays active — it resumes on the next firing once quota is available.

When does my monthly quota reset?

On your billing anchor date — the day of the month you originally upgraded (or the day your trial ended for Free plans). Visible on `/settings` → Billing under "Next reset".

Why HTTP 402 specifically?

RFC 7231 reserves 402 for "Payment Required". It's the standard semantic for an API rejecting a request on quota grounds. Useful if you're calling Callmine programmatically — handle 402 as "need to upgrade or buy add-on".