Receiving responses

This example was created in the sandbox. Therefore, you need to complete tasks as a trusted Toloker to process the results:

  1. Register as a Toloker in the Toloka sandbox.

  2. Log in to the sandbox with the requester's username and follow the Add trusted Tolokers link on the Users page.

  3. Click + Add user and enter the username of the account you created.

  4. Complete the tasks in the sandbox under the username of a trusted Toloker.

If at least one task from the pool is completed, you can get responses.

In the example given, Tolokers were not required to upload any files as a task responses. Therefore, you can get the responses themselves.

Get responses

Request

In the pool_id query parameter, replace {pool_id} with the ID of the pool you want to get responses for (the ID received in response to the add pool request).

Next, use the GET method:

cURL
Postman

Send a request from the command line using the cURL utility:

curl -X GET 'https://sandbox.toloka.dev/api/v1/assignments?pool_id={pool_id}' \
-H 'Authorization: ApiKey PlaceYourRealApiKey_Here'

Response

Toloker task suite responses are returned in the items array in the following format:

{
"items": [
{
"id": "00000f80eb-–617d0d2f515c446d68cc2785",
"task_suite_id": "00000f80eb-–617d0d2f515c446d68cc2783",
"pool_id": "9876543",
"user_id": "f2a33d6eb1d3c8f9c917adbf259c0539",
"status": "ACCEPTED",
"reward": 0.02,
"tasks": [
{
"id": "00000f80eb--617d0cbba52cc70d7118c5bc",
"input_values": {
"image": "https://example.com/image_3.jpg"
},
"pool_id": "9876543",
"overlap": 2,
"infinite_overlap": false,
"reserved_for": [],
"unavailable_for": [],
"created": "2021-10-30T09:13:31.153",
"remaining_overlap": 0
},
{
"id": "00000f80eb--617d0cbaa52cc70d7118c5b8",
"input_values": {
"image": "https://example.com/image_1.jpg"
},
"pool_id": "9876543",
"overlap": 2,
"infinite_overlap": false,
"reserved_for": [],
"unavailable_for": [],
"created": "2021-10-30T09:13:30.951",
"remaining_overlap": 0
},
{
"id": "00000f80eb--617d0cbba52cc70d7118c5ba",
"input_values": {
"image": "https://example.com/image_2.jpg"
},
"pool_id": "9876543",
"overlap": 2,
"infinite_overlap": false,
"reserved_for": [],
"unavailable_for": [],
"created": "2021-10-30T09:13:31.069",
"remaining_overlap": 0
}
],
"solutions": [
{
"output_values": {
"result": "boots"
}
},
{
"output_values": {
"result": "sneakers"
}
},
{
"output_values": {
"result": "boots"
}
}
],
"mixed": true,
"automerged": false,
"created": "2021-10-30T09:15:27.217",
"submitted": "2021-10-30T09:15:36.570",
"accepted": "2021-10-30T09:15:36.570",
"owner": {
"id": "9ea475935832de1dde0ece716c9df178",
"myself": true
}
},
{
"id": "00000f80eb--617d0d82a52cc70d7118c614",
"task_suite_id": "00000f80eb--617d0d82a52cc70d7118c612",
"pool_id": "1016043",
"user_id": "d01e518a746b149b07b81a10f4cfb1c2",
"status": "ACCEPTED",
"reward": 0.02,
"tasks": [
{
"id": "00000f80eb--617d0cbba52cc70d7118c5ba",
"input_values": {
"image": "https://example.com/image_2.jpg"
},
"pool_id": "9876543",
"overlap": 2,
"infinite_overlap": false,
"reserved_for": [],
"unavailable_for": [],
"created": "2021-10-30T09:13:31.069",
"remaining_overlap": 0
},
{
"id": "00000f80eb--617d0cbba52cc70d7118c5bc",
"input_values": {
"image": "https://example.com/image_3.jpg"
},
"pool_id": "9876543",
"overlap": 2,
"infinite_overlap": false,
"reserved_for": [],
"unavailable_for": [],
"created": "2021-10-30T09:13:31.153",
"remaining_overlap": 0
},
{
"id": "00000f80eb--617d0cbaa52cc70d7118c5b8",
"input_values": {
"image": "https://example.com/image_1.jpg"
},
"pool_id": "9876543",
"overlap": 2,
"infinite_overlap": false,
"reserved_for": [],
"unavailable_for": [],
"created": "2021-10-30T09:13:30.951",
"remaining_overlap": 0
}
],
"solutions": [
{
"output_values": {
"result": "sneakers"
}
},
{
"output_values": {
"result": "boots"
}
},
{
"output_values": {
"result": "sneakers"
}
}
],
"mixed": true,
"automerged": false,
"created": "2021-10-30T09:16:50.542",
"submitted": "2021-10-30T09:16:59.739",
"accepted": "2021-10-30T09:16:59.739",
"owner": {
"id": "9ea475935832de1dde0ece716c9df178",
"myself": true
}
}
],
"has_more": false
}
Contact support

Last updated: August 8, 2023

Toloka API
OverviewAccessing the APIRate limiting
Quick start
Configuration for Template BuilderToloker selection
Quality control rules
Filters
Task actions
Subscriptions to events
Reference
Project
Pool
Training
Webhook-subscription
Skill
User-restriction
Task
Task-suite
Operation
Assignment
Attachment
Aggregated-solution
User-bonus
Message-thread
User-metadata
Requester
All classes and methods