Get a list of Tolokers who have skills

Attention

The toloka.yandex.com domain will be disabled starting April 1, 2023. Please use the toloka.dev domain for API requests.

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

Production version
Sandbox
GET https://toloka.dev/api/v1/user-skills
Authorization: OAuth <OAuth token>

Headers

TitleOverview
AuthorizationA token for account authorization. Add OAuth as a prefix.

Query parameters

Query parameters are specified in the link after the question mark and separated by &.

ParameterOverview
user_idstring

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

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 value 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 parameterslimit, 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

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

Show the remaining tasks sorted by ascending ID

Production version
Sandbox
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>

Response

{"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}
PropertyDescription
items[]array of objects

Contains skill properties.
has_more

boolean

Shows whether the list is complete.

Acceptable values:

  • true — Not all elements are included in the output due to restrictions in the limit parameter.

    You can get the rest of the results by using the _lt(e) and _gt(e) parameters.

    Learn more about standard query parameters.

  • false — The output contains all the items.

Contact support
Toloka API
OverviewAccessing the APIRate limiting
Quick start
Reference
Project
Pools
Training
Subscriptions to events
Toloker selection
Ways to upload tasks
Tasks
Task suites
Tracking operations
Getting responses
Checking completed tasks
Rewards
Messages for Tolokers
Various parameters
Libraries