Get aggregated results

Attention

The toloka.yandex.com domain will be disabled starting July 1, 2023. Please use the toloka.dev domain for API requests.

Gets results of aggregation of responses from Tolokers.

Restriction

You can send a maximum of 5 requests of this kind per minute, 30 requests per hour, and 200 requests per day. Refer to the Rate limiting section for the complete list of the request limitations in Toloka API.

Request

Tip

Try our new API reference: more parameter details, request/response examples, and code samples in various programming languages, including the Toloka-Kit usage samples.

Production version
Sandbox
GET https://toloka.dev/api/v1/aggregated-solutions/<operation_id>
Authorization: OAuth <OAuth token>

Path parameters

ParameterOverview
operation_idOperation ID.

Headers

TitleOverview
AuthorizationA token for account authorization. Add OAuth as a prefix.

Query parameters

Query parameters are specified in the link after the question mark and separated by &.

ParameterOverview
sort

string

Parameters for sorting in ascending order:

  • task_id — Task ID.

    To change the sorting direction to descending, add a hyphen before the parameter: sort=-task_id.
Standard query parameterslimit, task_id_gt, task_id_gte, task_id_lt, task_id_lte.

Query example

You can set up the display of the list of results in parts (for example, 10 results at a time):

  1. Show the first 10 results, starting with the result with the lowest task ID.

  2. Show the remaining results (10 at a time) in ascending order.

Show the first 10 results

Production version
Sandbox
GET https://toloka.dev/api/v1/aggregated-solutions/<operation_id>?sort=task_id&limit=10
Authorization: OAuth <OAuth token>

Show the remaining tasks sorted by ascending ID

Production version
Sandbox
GET https://toloka.dev/api/v1/aggregated-solutions/<operation_id>?sort=task_id&limit=10&task_id_gt=<ID of the last task from the previous result>
Authorization: OAuth <OAuth token>

Response

{"items" : [{task #1}, {task #2}, ... {task #n}], "has_more": true}
PropertyDescription
items[]array of objects

Contains aggregation result.
has_more

boolean

Shows whether the list is complete.

Acceptable values:

  • true — Not all elements are included in the output due to restrictions in the limit parameter.

    You can get the rest of the results by using the _lt(e) and _gt(e) parameters.

    Learn more about standard query parameters.

  • false — The output contains all the items.

Contact support
Toloka API
OverviewAccessing the APIRate limiting
Quick start
Reference
Project
Pools
Training
Subscriptions to events
Toloker selection
Ways to upload tasks
Tasks
Task suites
Tracking operations
Getting responses
Checking completed tasks
Bonuses
Messages for Tolokers
Various parameters
Libraries