How to fix monthly_cap_exceeded (HTTP 402)
The free tier's 1,500 credits for this calendar month are used up.
What the API returns
{
"error": {
"code": "monthly_cap_exceeded",
"message": "free-plan monthly limit reached — upgrade to a paid plan or wait for the month reset",
"request_id": "770372810e5f2a70"
}
}Why it happens
- Normal free-tier usage over a month, or the same loops as daily_cap_exceeded.
How to fix it
- Upgrade on /pricing/ (Pro from ₹999 / $29 includes 1,25,000 credits) or wait for the first of next month.
- Cache aggressively; report endpoints cost 30–8,000 credits, so never call them on page load.
Should your code retry?
Not automatically. Retrying will return the same error until credits are available; surface it to whoever manages the account.
See all codes on the troubleshooting index and the error envelope on Errors. Still stuck? Email [email protected] with the request_id.