API Reference

VeyraCaptcha API

A 2captcha-compatible HTTP API. Create a task, poll for the result. Works with any language — cURL, Python, Node, Go, PHP, C#.

Quickstart

Send a task, get a taskId, poll until ready:

# 1. Create
curl -X POST https://tumbalkuncuy--veyracaptcha-api.modal.run/createTask \
  -H "Content-Type: application/json" \
  -d '{"clientKey":"veyra_xxx","task":{"type":"RecaptchaV2Task","websiteURL":"https://example.com","websiteKey":"6Lc..."}}'

# → {"errorId":0,"taskId":"abc123"}

# 2. Poll
curl "https://tumbalkuncuy--veyracaptcha-api.modal.run/getTaskResult?clientKey=veyra_xxx&taskId=abc123"

# → {"status":"ready","solution":{"gRecaptchaResponse":"03AGdBq..."}}

Authentication

Every request carries a clientKey — your API key from the dashboard. Keys are scoped and revocable. Never expose them in client-side code.

Endpoints

createTask

POST /createTask
{
  "clientKey": "veyra_xxx",
  "task": {
    "type": "RecaptchaV2Task",
    "websiteURL": "https://example.com",
    "websiteKey": "6Lc..."
  }
}

Task type maps to our solver type (lowercased, prefix-stripped). Response:

{ "errorId": 0, "taskId": "abc123" }

getTaskResult

GET /getTaskResult?clientKey=veyra_xxx&taskId=abc123

# processing
{ "errorId": 0, "status": "processing" }

# ready
{ "errorId": 0, "status": "ready", "solution": { "token": "..." } }

Type list

50 supported types. Filter: