Documentation
SolveGrid provides an asynchronous API for submitting recognition jobs against synthetic and explicitly authorized CAPTCHA challenges. It is designed for integration testing, provider benchmarking, and operator-owned environments.
Base URLs
| API | http://localhost:4000/api/v1 |
| OpenAPI / Swagger UI | https://captcha.yallasystems.com/api/docs |
Core concepts
- Jobs — every recognition request is an async job with a strict lifecycle:
queued → processing → succeeded | failed | timed_out | cancelled. - Providers — pluggable recognition backends. The bundled
local-demoprovider solves deterministic synthetic fixtures only. - Credits — jobs are billed in credits from an auditable ledger; failed jobs are refunded automatically.
- Capabilities —
GET /recognition/capabilitiesreports what is tested, configured, unavailable, or unsupported.
Honesty model
Job results always include provider and executionMode. Results from the local provider are marked demo. The platform never returns fabricated results for pending or failed jobs — check status before reading result.
Start with Getting started, then see Authentication and Jobs & polling.