# `INSUFFICIENT_CREDITS` (HTTP 402): 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.

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.

```json
{
    "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"
    }
}
```

Reference: https://spaw.co/docs/errors/INSUFFICIENT_CREDITS