Get Task Result API

The Solverify Get Task Result API checks the status of a previously created CAPTCHA solving task and returns the final solution when processing is complete. Use POST /getTaskResult with the taskId returned by POST /createTask.

POST /GetTaskResult is also supported as an alias for POST /getTaskResult.

Request

{
  "clientKey": "YOUR_API_KEY",
  "taskId": "UUID"
}

Task Statuses

Status	Meaning
`pending`	The task is queued and waiting for available solver capacity.
`processing`	The task has been claimed and is currently being solved.
`completed`	The task finished successfully and includes `solution`.
`failed`	The task failed and returns an API error response.

Pending Response

{
  "errorId": 0,
  "status": "pending",
  "errorCode": null,
  "errorDescription": null
}

Processing Response

{
  "errorId": 0,
  "status": "processing",
  "errorCode": null,
  "errorDescription": null
}

Completed Response

{
  "errorId": 0,
  "status": "completed",
  "solution": {
    "value": "",
    "cookies": {},
    "headers": {},
    "useragent": "Mozilla/5.0 ...",
    "html": "<html>...</html>"
  },
  "errorCode": null,
  "errorDescription": null
}

Solution Fields

solution fields vary by task type:

Field	Description
`value`	Token, OCR text, or task-specific value.
`cookies`	Cookies returned by browser and cookie-based task types.
`headers`	Headers returned when a solver captures required request headers.
`useragent`	User-agent used by the solver session.
`html`	HTML returned only by task types that support source capture.

Failed Response

{
  "errorId": 1,
  "errorCode": "ERROR_TASK_FAILED",
  "errorDescription": "Task failed to solve"
}

If the taskId does not exist or belongs to a different API key, the API returns ERROR_TASK_NOT_FOUND.

For the full list of error responses, see Solverify API Error Codes.