Captcha OCR

The credits header on a solve

2026-03-25 · Using the API

Successful solves include X-Credits-Remaining so you do not need a second call to show a balance.

The solve response carries X-Credits-Remaining. That is the balance after this call settled. You can show it in a log line.

GET /v1/balance returns the same number as JSON, plus the alert threshold if you set one. Use it when you do not have a solve in hand.

The header is not present on a 401, because there is no account. On a 402 the body includes credits so you can see how short you are.

Balance checks are cheap. Do not poll them in a tight loop. Poll after a batch, or read the header you already have.

Ready to call it? Start with the quickstart, the API guide, or pricing.

More in Using the API