Get the list of tasks

  1. Request
  2. Headers
  3. Query parameters
  4. Query example
  5. Response

Gets the list of tasks in the pool.

Request

GET https://toloka.yandex.com/api/v1/tasks
Authorization: OAuth <OAuth token>

Headers

Title Overview
authorization A token for account authorization. Add OAuth as a prefix.
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

pool_id

string | required

ID of the pool to get tasks from.

sort

string

Parameters for sorting in ascending order:

  • id — Task ID.

  • created — Date the task was created, in UTC in the format YYYY-MM-DD.

To change the sorting direction to descending, add the minus sign before the parameter. For example, sort=-id.

This query supports multiple sorts that must be specified in a desired sequence:

  • created,id — Sort ascending first by the date the task was created, then by the task ID.
  • -created,-id — Sort descending first by the date the task was created, then by the task ID.
overlap

integer

Tasks with an overlap equal to the specified value.

Standard query parameters limit, id_gt, id_gte, id_lt, id_lte, created_gt, created_gte, created_lt, created_lte, overlap_gt, overlap_gte, overlap_lt, overlap_lte
Parameter Overview

pool_id

string | required

ID of the pool to get tasks from.

sort

string

Parameters for sorting in ascending order:

  • id — Task ID.

  • created — Date the task was created, in UTC in the format YYYY-MM-DD.

To change the sorting direction to descending, add the minus sign before the parameter. For example, sort=-id.

This query supports multiple sorts that must be specified in a desired sequence:

  • created,id — Sort ascending first by the date the task was created, then by the task ID.
  • -created,-id — Sort descending first by the date the task was created, then by the task ID.
overlap

integer

Tasks with an overlap equal to the specified value.

Standard query parameters limit, id_gt, id_gte, id_lt, id_lte, created_gt, created_gte, created_lt, created_lte, overlap_gt, overlap_gte, overlap_lt, overlap_lte

Query example

You can set up the display of the list of tasks in parts (for example, 10 tasks at a time):
  1. Show the first 10 tasks, starting with the task with the lowest ID.
  2. Show the remaining tasks (10 at a time) in ascending order.
Show the first 10 tasks
GET https://toloka.yandex.com/api/v1/tasks?sort=id&limit=10
Authorization: OAuth <OAuth token>
Show the remaining responses sorted by ascending ID
GET https://toloka.yandex.com/api/v1/tasks?sort=id&limit=10&id_gt=<ID of the last task from the previous response>
Authorization: OAuth <OAuth token>

Response

Contains task data in the items array.

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