Toloka documentation

Get aggregate responses

Warning

We recommend that you use the toloka.dev domain for API requests. The toloka.yandex.com domain is still supported but it will be deprecated soon.

Gets aggregated responses.

Request

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

Path parameters

Parameter Overview
operation_id Operation ID.

Headers

Title Overview
Authorization A token for account authorization. Add OAuth as a prefix.

Query parameters

Specified in the link after the question mark; separated by &.

Parameter

Overview

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 parameters

limit, task_id_gt, task_id_gte, task_id_lt, task_id_lte.

Query example

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

  1. Show the first 10 responses, starting with the response with the lowest task ID.
  2. Show the remaining responses (10 at a time) in ascending order.

Show the first 10 responses

GET https://toloka.dev/api/v1/aggregated-solutions/<operation_id>?sort=task_id&limit=10
Authorization: OAuth <OAuth token>
GET https://sandbox.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

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 response>
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/aggregated-solutions/<operation_id>?sort=task_id&limit=10&task_id_gt=<ID of the last task from the previous response>
Authorization: OAuth <OAuth token>

Response

Aggregation result in the items array.

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