client.expertBanList.listExpertsPage()

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

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

const page = await client.expertBanList.listExpertsPage({
  projectId: "pp.019a0000-0000-7000-8000-000000000001"
});
console.log(page);

{
  "experts": [
    {
      "expertId": "<string>",
      "reason": "<string>",
      "status": "pending",
      "createdAt": "2026-01-01T00:00:00Z"
    }
  ],
  "nextAfter": null
}

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

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

const page = await client.expertBanList.listExpertsPage({
  projectId: "pp.019a0000-0000-7000-8000-000000000001"
});
console.log(page);

{
  "experts": [
    {
      "expertId": "<string>",
      "reason": "<string>",
      "status": "pending",
      "createdAt": "2026-01-01T00:00:00Z"
    }
  ],
  "nextAfter": null
}

Return a page of the experts in the project’s own ban list with their status, sorted by expert ID. Team-wide bans are not listed.

Signature

Method signature on client.expertBanList:

listExpertsPage(args: {
  projectId: string;
  after?: string;
  limit?: number;
}): Promise<{ experts: ExpertBanListExpert[]; nextAfter: null | string }>;

Parameters

string

required

Project ID with prefix pp..

string

Return experts after this expert ID; use nextAfter of the previous page.

number

default:"1000"

Maximum number of experts to return, from 1 to 1000.

Returns

Promise<{ experts: ExpertBanListExpert[]; nextAfter: null | string }>

ExpertBanListExpert[]

required

Experts in this page.

Show Fields

string

required

ID of the banned expert.

string

required

Why the expert was banned.

"pending" | "banned" | "not_found" | "unbanning" | "unbanned"

required

pending and unbanning are being applied; banned is in force; not_found matches no expert; unbanned was lifted.

string

required

Time the expert was banned, as an ISO 8601 timestamp.

string | null

required

Pass as after to get the next page; null on the last page.

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 /projects/{projectId}/expert-ban-list/experts.

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

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

const page = await client.expertBanList.listExpertsPage({
  projectId: "pp.019a0000-0000-7000-8000-000000000001"
});
console.log(page);

{
  "experts": [
    {
      "expertId": "<string>",
      "reason": "<string>",
      "status": "pending",
      "createdAt": "2026-01-01T00:00:00Z"
    }
  ],
  "nextAfter": null
}

Reference

TypeScript SDK

CLI

HTTP API

client.expertBanList.listExpertsPage()

Signature

Parameters

Returns

Errors

​Signature

​Parameters

​Returns

​Errors

Signature

Parameters

Returns

Errors