Toloka documentation

Receiving responses

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.

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.dev/api/v1/assignments?pool_id=<pool id>

Fill in the fields:

  1. Request URL

    https://sandbox.toloka.dev/api/v1/assignments?pool_id=<pool id>
    
  2. Headers

    Authorization: OAuth <OAuth token>
    

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.dev/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.dev/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.dev/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": "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://sandbox.toloka.dev/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.dev/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.dev/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": "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
}