​
Get Task Result

Retrieves the result of a previously created captcha solving task.

​
API Endpoint

POST /getTaskResult

​
Request Parameters

​
clientKey
string
required
Your API key.
​
taskId
string
required
The ID of the task returned by the createTask request.

​
Response

​
status
string
The status of the task. Can be one of:
  • processing - The task is still being processed
  • ready - The task has been completed
  • failed - The task has failed
​
solution
object
The solution data. Only present when status is ready.
​
error
object
Error details. Only present when status is failed.
​
solution.gRecaptchaResponse
string
The reCAPTCHA response token. Only present for reCAPTCHA tasks.
​
solution.token
string
The hCaptcha response token. Only present for hCaptcha tasks.
​
solution.token
string
The Turnstile response token. Only present for Turnstile tasks.
​
solution.text
string
The text from the image. Only present for ImageToText tasks.
​
solution.score
number
The score value for reCAPTCHA v3. Only present for reCAPTCHA v3 tasks.
​
solution.userAgent
string
The User-Agent used to solve the captcha. Present if a custom User-Agent was used.

​
Example Request

curl -X POST https://captcha.vast.sh/api/solver/getTaskResult \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "YOUR_API_KEY",
    "taskId": "9d55c404-5a45-4e7b-8a93-b8ed9f26bdcf"
  }'

​
Example Response - Processing

{
  "status": "processing"
}

​
Example Response - Ready (reCAPTCHA)

{
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AGdBq25nDZASDNcKOSrPQJ2Qy7RgC8GzP64fZunlJ-KFk2bvOr9kRCdvlrqrn8c3M2cXY..."
  }
}

​
Example Response - Ready (hCaptcha)

{
  "status": "ready",
  "solution": {
    "token": "P1_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJwYXNza2V5IjoiRXJ1SU..."
  }
}

​
Example Response - Failed

{
  "status": "error",
  "error": {
    "errorId": 1,
    "errorCode": "ERROR_CAPTCHA_UNSOLVABLE",
    "errorDescription": "The captcha could not be solved"
  }
}

​
Error Codes

Common error codes:
  • ERROR_CAPTCHA_UNSOLVABLE - The captcha could not be solved
  • ERROR_KEY_DOES_NOT_EXIST - Invalid API key
  • ERROR_TASK_NOT_FOUND - Task not found
  • ERROR_PROXY_CONNECTION_FAILED - Proxy connection failed

​
Notes

  • The solution format varies depending on the captcha type.
  • You should poll this endpoint until the status is either ready or failed. We recommend using a polling interval of 3-5 seconds.
  • The solution is typically ready within 5-30 seconds, depending on the captcha type and difficulty.