OpenAI 429 "Credit balance exhausted" (credit_balance_exhausted)

What does the error mean?

The response is HTTP 429 with error.code set to credit_balance_exhausted. OpenAI’s error table titles it “429 - Credit balance exhausted” and gives the cause as “Your organization has no prepaid credits remaining.”

The broader error.type can still say insufficient_quota. Code that only checks the type will report it as the older “You exceeded your current quota” error, so read error.code to tell the cases apart.

How do you fix it?

1. Open the billing overview. Make sure it’s the organization your API key belongs to.
2. Select Buy credits or Add to credit balance, whichever appears. The minimum is $5.
3. Wait a few minutes. OpenAI says the new balance can take that long to show.
4. Retry the failed requests once the balance is positive. If the purchase amount looks short, an earlier negative balance was probably taken out of it.

If the payment itself fails, OpenAI shows an error and adds no credits. Try another card, or ask your bank why it declined.

Why didn’t auto recharge catch it?

Auto recharge buys credits when your balance drops below a threshold you set. When it doesn’t fire, start with the email. OpenAI sends one when a recharge payment fails, and usage carries on until the balance runs out.

Next, check the monthly recharge limit if you set one. Once it’s used up, automatic recharges stop until the next month, though manual purchases still go through.

Then look at the threshold itself. Usage is charged with a short delay, so heavy traffic can drain a small buffer before a recharge lands. Also confirm the payment method and threshold are set on the same organization as the key.

How do you keep it from coming back?

Pick a threshold that covers a few hours of your normal usage. Your trust tier caps how much a single recharge can add, so on a busy account a higher threshold helps more than a bigger recharge.

Keep the card behind auto recharge in good shape, too. A declined recharge only shows up as an email, so it’s easy to miss. Some teams put AI vendors on their own card for that reason, and ernd is a card for AI spend that earns 4% back.

Spend alerts help as well. They notify you as spend passes a threshold and never block traffic.