Accessing the API

Attention

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

All requests to the Toloka API must specify the resource URL and the OAuth token.

Query example

GET https://sandbox.toloka.dev/api/v1/assignments?pool_id=12345
Authorization: OAuth <OAuth token>

Resource URL

  • For requests to the sandbox: https://sandbox.toloka.dev/api/v1/<path_to_resource>.

  • For requests to the production version: https://toloka.dev/api/v1/<path_to_resource>.

Getting an OAuth token

Working with the Toloka API requires an OAuth access token. Register in Toloka and get an OAuth token in the requester interface:

Accessing the API

Troubleshooting

My Toloka token expired. How or where can I find its lifetime?
I can't make an API request, the platform returns the “Access denied” error. What's the reason for the problem?
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
Bonuses
Messages for Tolokers
Various parameters
Libraries