Skip to content

429 Quota exceeded

You have used the requests included in your plan for this billing period.

The response body tells you which of two situations you are in — check the reason field, because the fix is different.

reason: "hard_cap"

Your account is set to stop at the included requests rather than bill overage. This is the default, and it is what guarantees your bill never exceeds your plan price.

To resume immediately, either:

  • Allow overage in Billing, optionally with a spend cap so you still control the ceiling, or
  • Upgrade to a plan with a larger included requests.

Free accounts are always hard capped and cannot enable overage.

reason: "spend_cap"

You allowed overage but set a spend cap, and usage has now reached it. You have not been charged beyond the cap. Raise or remove it in Billing.

Either way

Usage resets at resetAt in the response body (a Unix timestamp). Changes to your plan or caps take effect within 30 seconds.

If this surprised you, check the per-key breakdown on your project page — a single misconfigured page calling on every render is the usual cause.