402
Do not retryPayment required — Metered plans only — your credit balance reached zero.
Response body
{ "error": { "code": "credit_balance_exhausted", … } }
Should you retry?
No — the same request will fail the same way. Fix it first.
What it means
Never returned on a subscription plan, which is unmetered. If you are seeing this and believe you are on a subscription, check billing_mode on GET /v4/me — it will say credits.
Common causes
- The balance hit zero mid-integration.
- A backfill consumed more credits than expected; every returned record costs one.
- Your plan's monthly allowance is spent and the period has not rolled over yet. Buy a top-up pack to continue now — purchased credits never expire, so anything left rides into the next period.
How to fix it
Top up to resume: watch X-Credit-Balance, which rides on every credits-mode response, and the X-Credit-Low signal that appears before you hit zero. Size result sets with ?count=true first — counts are free, and they keep working at a zero balance, as do GET /v4/me, GET /v4/usage and every …/options endpoint.
Endpoints that return this
Read from the OpenAPI specification, so this list cannot claim an endpoint returns a status the contract does not list.
| Method | Endpoint | What it does |
|---|---|---|
| GET | /v4/jobs | Search jobs |
| GET | /v4/sources | Search sources (companies) |