Toloka documentation

Get aggregate responses

Gets aggregated responses.

Request

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