Spaw
Get your API key

INSUFFICIENT_CREDITS

The credit balance is empty

The account has no credits left, so the lookup did not run. Free credits renew at the start of each month; packs can be bought from the Billing page.

http status
402
credits
Nothing is billed for a failed request.

What it means

Spaw checks the balance before doing any work, so a 402 always means nothing was probed and nothing was charged. Every account receives 10 free credits each calendar month; credit packs bought through the dashboard never expire.

A batch that runs out of credits part-way answers 200 with the results paid for so far and meta.stopped_reason set to insufficient_credits; only a batch whose first lookup is refused returns this error.

What to do

Buy a credit pack from the Billing page, or wait for the monthly grant. GET /api/v1/account returns the live balance for pre-flight checks.

Example response 

{
    "success": false,
    "error": {
        "code": "INSUFFICIENT_CREDITS",
        "message": "You have run out of credits. Your free credits renew at the start of each month.",
        "request_id": "req_01m1kgdm4xngzmbmff68g94w0c"
    }
}

Every error carries the request_id also sent in the X-Request-Id header; quote it when writing to support.

Related

markdown version: /docs/errors/INSUFFICIENT_CREDITS.md