> ## 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.get()

> Get the expert ban list of a project.

Return how many experts are in the project's own ban list and how many are in each status. Banned experts cannot work on the project. Team-wide bans also apply but are managed in the platform UI and not counted here. Available only to teams with expert bans enabled.

## Signature

Method signature on `client.expertBanList`:

```ts theme={null}
get(args: {
  projectId: string;
}): Promise<ExpertBanListDetails>;
```

## Parameters

**projectId** `string` *required*

Project ID with prefix `pp.`.

## Returns

`Promise<ExpertBanListDetails>`

The expert ban list of a project: experts who cannot work on it.

**projectId** `ProjectId` *required*

Project ID with prefix `pp.`.

**expertCount** `number` *required*

Number of experts in the ban list.

**stats** `object` *required*

How many experts of the ban list are in each status.

**Fields**

**pending** `number` *required*

Bans still being applied.

**banned** `number` *required*

Bans in force.

**notFound** `number` *required*

IDs that match no expert.

**unbanning** `number` *required*

Bans being lifted.

## 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`](https://docs.platform.toloka.ai/docs/api-reference/expert-ban-list/get-expert-ban-list).

```ts get() theme={null}
import { createClient } from "@toloka-platform/sdk";

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

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

```json get() theme={null}
{
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "expertCount": 0,
  "stats": {
    "pending": 0,
    "banned": 0,
    "notFound": 0,
    "unbanning": 0
  }
}
```


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