client.expertLists.get()

import { createClient } from "@toloka-platform/sdk";

const client = createClient({
  baseUrl: "https://platform.toloka.ai",
  apiKey: process.env.TOLOKA_API_KEY!,
});

const expertListDetails = await client.expertLists.get({
  expertListId: "exl.019a0000-0000-7000-8000-000000000001"
});
console.log(expertListDetails);

{
  "id": "exl.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "hidden": false,
  "expertCount": 0,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z",
  "stats": {
    "available": 0,
    "pending": 0,
    "unavailable": 0,
    "notFound": 0,
    "banned": 0
  }
}

import { createClient } from "@toloka-platform/sdk";

const client = createClient({
  baseUrl: "https://platform.toloka.ai",
  apiKey: process.env.TOLOKA_API_KEY!,
});

const expertListDetails = await client.expertLists.get({
  expertListId: "exl.019a0000-0000-7000-8000-000000000001"
});
console.log(expertListDetails);

{
  "id": "exl.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "hidden": false,
  "expertCount": 0,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z",
  "stats": {
    "available": 0,
    "pending": 0,
    "unavailable": 0,
    "notFound": 0,
    "banned": 0
  }
}

Return an expert list with how many of its experts are in each status.

Signature

Method signature on client.expertLists:

get(args: {
  expertListId: string;
}): Promise<ExpertListDetails>;

Parameters

string

required

ID of the expert list, with prefix exl..

Returns

Promise<ExpertListDetails>

string

required

ID of the expert list, with prefix exl..

ProjectId

required

Project ID with prefix pp..

string

required

Name of the expert list, shown when picking a list for a node.

boolean

required

Experts cannot be added to or removed from a hidden list until it is shown again. Nodes that use it keep working.

number

required

Number of experts in the list.

string

required

Time the list was created, as an ISO 8601 timestamp.

string

required

Time the list was last changed, as an ISO 8601 timestamp.

ExpertListStats

required

How many experts of the list are in each status.

Show Fields

number

required

Experts who can take tasks now.

number

required

Experts whose availability is still being checked.

number

required

Experts who exist but cannot take tasks now.

number

required

IDs that match no expert.

number

required

Experts banned in this project.

Errors

HTTP errors throw PotatoApiError. The endpoint documents these error responses:

Status	Description
404	Project or expert list not found, or not available for it
429	Rate limit exceeded

HTTP endpoint: GET /expert-lists/{expertListId}.

import { createClient } from "@toloka-platform/sdk";

const client = createClient({
  baseUrl: "https://platform.toloka.ai",
  apiKey: process.env.TOLOKA_API_KEY!,
});

const expertListDetails = await client.expertLists.get({
  expertListId: "exl.019a0000-0000-7000-8000-000000000001"
});
console.log(expertListDetails);

{
  "id": "exl.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "hidden": false,
  "expertCount": 0,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z",
  "stats": {
    "available": 0,
    "pending": 0,
    "unavailable": 0,
    "notFound": 0,
    "banned": 0
  }
}

Reference

TypeScript SDK

CLI

HTTP API

Signature

Parameters

Returns

Errors

​Signature

​Parameters

​Returns

​Errors

Signature

Parameters

Returns

Errors