Toloka documentation

Get the list of tasks

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 the list of tasks in the pool.

Request

GET https://toloka.dev/api/v1/tasks
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/tasks
Authorization: OAuth <OAuth token>

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

pool_id

string | required

ID of the pool to get tasks from.

sort

string

Parameters to sort by:

  • id — Task ID.
  • created — The task creation date in UTC using ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss].

To learn how to configure sorting, see Sorting the list of objects.

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

Show the remaining tasks sorted by ascending ID

GET https://toloka.dev/api/v1/tasks?sort=id&limit=10&id_gt=<ID of the last task from the previous response>
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/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}