Get task result

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.