Active Tasks API | Solverify

Monitor active Solverify CAPTCHA tasks by target website with the Active Tasks API. A single POST /activeTasks request returns pending and processing task counts grouped by the websiteURL supplied during task creation.

Use this endpoint to measure queue pressure, identify websites with high task volume, build operational dashboards, or reduce submissions when existing work is still active.

Authentication is provided through the clientKey field in the JSON request body.

Request Body

{
  "clientKey": "YOUR_API_KEY"
}

Field	Type	Required	Description
`clientKey`	string	Yes	Your private Solverify API key.

Store the API key in a server-side environment variable or secret manager. Do not expose it in frontend JavaScript or public source code.

Success Response

A successful request returns errorId: 0 and a websites array containing active task counters:

{
  "errorId": 0,
  "websites": [
    {
      "website_url": "https://example.com",
      "pending_count": 5,
      "processing_count": 2,
      "total_count": 7
    }
  ],
  "errorCode": null,
  "errorDescription": null
}

Response Fields

Field	Type	Description
`errorId`	number	`0` indicates that the request succeeded. `1` indicates an API error.
`websites`	array	Active task counters grouped by target website URL.
`website_url`	string	Website URL supplied when tasks in this group were created.
`pending_count`	number	Number of queued tasks waiting for solver capacity for this website.
`processing_count`	number	Number of tasks currently being solved for this website.
`total_count`	number	Sum of `pending_count` and `processing_count` for this website.
`errorCode`	string or null	Machine-readable error code when the request fails.
`errorDescription`	string or null	Human-readable information about the error.

Task creation uses the camel-case field websiteURL, while this response returns the grouped URL as website_url.

Active Tasks Code Examples

The following examples retrieve active CAPTCHA task counts and display the queue for each target website.

curl --request POST \
  --url https://solver.solverify.net/activeTasks \
  --header "Content-Type: application/json" \
  --data '{"clientKey":"YOUR_API_KEY"}'

Active Tasks API Errors

Error code	Description
`ERROR_INVALID_REQUEST`	The request body is missing required fields or contains invalid JSON.
`ERROR_INVALID_KEY`	The supplied Solverify API key is invalid.

Always inspect errorId before reading the websites array. For every supported API error, see Solverify API Error Codes.

How to Use Active Task Counts

Use the website-level counters to make informed submission decisions:

Monitor pending CAPTCHA tasks for signs of queue pressure.
Identify target websites receiving the highest task volume.
Reduce or pause submissions when a website already has substantial active work.
Compare queued tasks with tasks that are actively processing.
Display website-level activity in an internal operations dashboard.

The endpoint returns aggregate counters rather than individual task results. Use the Get Task Result API to retrieve the status and solution for a specific task. Use the Get Profile API when you only need account-wide pending and processing totals.

Frequently Asked Questions

What does the Active Tasks API return?

It returns pending, processing, and total active task counts grouped by target website URL for the supplied API key.

What is the difference between `pending_count` and `processing_count`?

pending_count represents queued tasks waiting for solver capacity. processing_count represents tasks that have already been assigned and are currently being solved.

How is `total_count` calculated?

total_count is the sum of pending_count and processing_count for a website group.

Does this endpoint return completed tasks?

No. The response describes active pending and processing work. Retrieve an individual task's final status and solution with POST /getTaskResult.

Does the Active Tasks API create or cancel tasks?

No. It is a monitoring endpoint that reports task counters. It does not create, modify, or cancel CAPTCHA tasks.