Toloka documentation

Get a list of Tolokers who have skills

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 a list of Tolokers who have skills. With the query parameters, you can filter the data in the response the following way:

  • Get the list of all the Tolokers who have the specific skill using the skill_id query parameter:

    GET https://toloka.dev/api/v1/user-skills?skill_id=<skill_id>
    
  • Get the list of all the skills assigned to the specific Toloker using the user_id query parameter:

    GET https://toloka.dev/api/v1/user-skills?user_id=<user_id>
    

Request

GET https://toloka.dev/api/v1/user-skills
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/user-skills
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

user_id

string

Toloker ID. It is used to get the list of the skills assigned to the specific Toloker.

skill_id

string

Skill ID. It is used to get the list of the Tolokers who have the specific skill.

sort

string

Parameters to sort by:

  • id — Skill ID.
  • created — The date when the skill was created, in UTC in the YYYY-MM-DD format.
  • created — The date when the skill was changed, in UTC in the YYYY-MM-DD format.

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

Standard query parameters

limit, id_gt, id_gte, id_lt, id_lte, created_gt, created_gte, created_lt, created_lte, modified_gt, modified_gte, modified_lt, modified_lte.

Query example

You can set up the display of the list of skills in parts (for example, 10 skills at a time):

  1. Show the first 10 skills, starting with the skill with the lowest ID.
  2. Show the remaining skills (10 at a time) in ascending order.

Show the first 10 skills

GET https://toloka.dev/api/v1/user-skills?sort=id&limit=10
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/user-skills?sort=id&limit=10
Authorization: OAuth <OAuth token>

Show the remaining tasks sorted by ascending ID

GET https://toloka.dev/api/v1/skills?sort=id&limit=10&id_gt=<ID of the last skill from the previous response>
Authorization: OAuth <OAuth token>
GET https://sandbox.toloka.dev/api/v1/skills?sort=id&limit=10&id_gt=<ID of the last skill from the previous response>
Authorization: OAuth <OAuth token>

Response

Skill properties in the items array:

{"items" : [{<Toloker 1 skill 1 >}, {<Toloker 1 skill 2>}, ... {<Toloker 1 skill n>}, ... {<Toloker n skill 1>}, {<Toloker n skill 2>}, ... {<Toloker n skill n>}], "has_more": false}