Get Task Result

Retrieve the result of a captcha solving task.

POST/getTaskResult

Request Body

Parameter	Type	Required	Description
`clientKey`	string	Yes	Your API key
`taskId`	string	Yes	Task ID from createTask response

Example Request

terminal

curl -X POST https://api.regotcha.com/getTaskResult \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "YOUR_API_KEY",
    "taskId": "task_abc123xyz789"
  }'

Response

Processing

processing.json

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

Ready (basic)

ready.json

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AGdBq24PBCbwiDRaS_MJ7Z2..."
  }
}

Ready (with forwardResponse)

When using forwardRequest, the response includes the forward result:

ready-with-forward.json

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AGdBq24PBCbwiDRaS_MJ7Z2..."
  },
  "forwardResponse": {
    "statusCode": 200,
    "headers": {
      "content-type": "application/json"
    },
    "body": "{\"success\": true, \"userId\": 123}",
    "error": null
  }
}

Ready (forward failed, token still available)

ready-forward-failed.json

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AGdBq24PBCbwiDRaS_MJ7Z2..."
  },
  "forwardResponse": {
    "statusCode": 0,
    "headers": {},
    "body": "",
    "error": "Request timeout"
  }
}

Failed

error.json

{
  "errorId": 1,
  "errorCode": "ERROR_CAPTCHA_UNSOLVABLE",
  "errorDescription": "Captcha could not be solved"
}

Polling Strategy

We recommend polling every 5 seconds until the task is complete. Average solve time is ~30 seconds, with most tasks completing within 3 minutes.

Recommended: Start polling after 10 seconds, then every 5 seconds. This reduces unnecessary requests while the solver works.

Solution Object

Field	Type	Description
`gRecaptchaResponse`	string	The reCAPTCHA token to submit

forwardResponse Object

Only present when forwardRequest was specified in createTask.

Field	Type	Description
`statusCode`	number	HTTP status code (0 if request failed)
`headers`	object	Response headers (Content-Type, Date, Content-Length)
`body`	string	Response body (max 10KB)
`error`	string \| null	Error message if request failed

Error Codes

Code	Description
`ERROR_NO_SUCH_TASK`	Task ID not found or expired
`ERROR_CAPTCHA_UNSOLVABLE`	Captcha could not be solved
`ERROR_TASK_TIMEOUT`	Task exceeded maximum processing time

Note: Failed tasks do not consume credits. You are only charged for successful solves.