What happens when I hit my quota?
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
reasonfield — usuallyquota_exceeded. - ·An
upgrade_optionsarray — plans you could upgrade to and the monthly call counts they unlock. - ·An
addon_availableboolean — 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.