Receiving responses

  1. Get responses
  2. Learn more

This example was created in the sandbox. Therefore, you need to perform tasks as a trusted user 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 users link on the Users page.

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

  4. Perform the tasks in the sandbox under the username of a trusted user.

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 response to tasks. 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:

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

curl -X GET \
     -H 'Authorization: OAuth <OAuth token>' \
https://sandbox.toloka.yandex.com/api/v1/assignments?pool_id=<pool id>
Copied to clipboard

Response

Toloker 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://sandbox.toloka.yandex.com/api/proxy/thgn1/photos/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://sandbox.toloka.yandex.com/api/proxy/thgn1/photos/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://sandbox.toloka.yandex.com/api/proxy/thgn1/photos/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": "dog"
               }
            },
            {
               "output_values": {
                  "result": "cat"
               }
            },
            {
               "output_values": {
                  "result": "dog"
               }
            }
         ],
         "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://sandbox.toloka.yandex.com/api/proxy/thgn1/photos/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://sandbox.toloka.yandex.com/api/proxy/thgn1/photos/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://sandbox.toloka.yandex.com/api/proxy/thgn1/photos/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": "cat"
               }
            },
            {
               "output_values": {
                  "result": "dog"
               }
            },
            {
               "output_values": {
                  "result": "cat"
               }
            }
         ],
         "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
}

Click on the parameter in the sample response to see its brief description.