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

ready.json

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

Failed

error.json

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

Polling Strategy

We recommend polling every 3-5 seconds until the task is complete. Most tasks complete within 10 seconds.

Best Practice: Implement exponential backoff starting at 3 seconds. This reduces unnecessary requests while maintaining responsiveness.

Solution Object

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

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.