> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.toloka.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# client.expertBanList.listExpertsPage()

> List the experts of the expert ban list.

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`:

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

## Parameters

**projectId** `string` *required*

Project ID with prefix `pp.`.

**after** `string`

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

**limit** `number` (default: 1000)

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

## Returns

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

**experts** `ExpertBanListExpert[]` *required*

Experts in this page.

**Fields**

**expertId** `string` *required*

ID of the banned expert.

**reason** `string` *required*

Why the expert was banned.

**status** `"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.

**createdAt** `string` *required*

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

**nextAfter** `string | null` *required*

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

## Errors

HTTP errors throw [`PotatoApiError`](https://docs.platform.toloka.ai/docs/sdk/errors). 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`](https://docs.platform.toloka.ai/docs/api-reference/expert-ban-list/list-expert-ban-list-experts).

```ts listExpertsPage() theme={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);
```

```json listExpertsPage() theme={null}
{
  "experts": [
    {
      "expertId": "<string>",
      "reason": "<string>",
      "status": "pending",
      "createdAt": "2026-01-01T00:00:00Z"
    }
  ],
  "nextAfter": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.