OpenAI "You exceeded your current quota" (insufficient_quota)

What does the error mean?

The message most people see is You exceeded your current quota, please check your plan and billing details. It arrives as HTTP 429 with the error type insufficient_quota.

The status code makes it look like a rate limit. It isn’t one. Your organization has no budget left for the request, and OpenAI says retrying a billing or quota error won’t restore access.

OpenAI’s current error codes page no longer prints that sentence. It tells you to read error.code for the specific cause, and notes that error.type can still be insufficient_quota. The full sentence is what you’ll find in older SDK output and on the OpenAI forum.

error.code	What happened	Fix
credit_balance_exhausted	No prepaid credits left	Add credits
organization_spend_limit_exceeded	The organization hit a hard spend limit you set	Raise or remove that limit
project_spend_limit_exceeded	One project hit its hard spend limit	Raise it in the project’s settings
organization_usage_limit_exceeded	The organization hit the monthly usage limit OpenAI assigned	Request a higher limit, or reach the next tier

Codes as listed on OpenAI’s Error codes page, checked November 5, 2026.

How do you fix it?

1. Log the full error body and read error.code. It tells you which row above you’re in.
2. For credit_balance_exhausted, open the billing overview for the organization the key belongs to and select Buy credits or Add to credit balance. The minimum purchase is $5.
3. Wait a few minutes before you retry. OpenAI says the balance can take that long to update, and any negative balance from the gap is taken out of the purchase.
4. For a spend limit, go to Organization limits (or Project settings, then Limits), select Edit spend limit under Spend, and raise or remove it.
5. For the usage limit, go to Settings, then Organization, then Limits, and ask OpenAI for a higher limit. Buying enough credits to reach the next tier raises it too. Our OpenAI rate limits guide has the tier table.
6. Stop any retry loop until one of those changes has gone through.

How do you keep it from coming back?

Turn on auto recharge in billing. You set a balance threshold, the balance to restore to and an optional monthly recharge limit, and each recharge is at least $5. Then add spend alerts a little below any hard limit, since alerts warn you without stopping traffic.

Auto recharge only works if the payment goes through. If it fails, OpenAI sends an email and usage stops once the balance runs out. A card used only for AI vendors is easier to keep an eye on, and ernd is that kind of card, with 4% back on AI spend.

The credit balance exhausted page covers failed recharges in more detail.