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

> List dataset slices.

Return a page of slices, newest first, with their status and row counts.

## Signature

Method signature on `client.datasets`:

```ts theme={null}
listSlicesPage(args: {
  datasetId: string;
  limit?: number;
  offset?: number;
}): Promise<{ slices: DatasetSlice[]; pagination: Pagination }>;
```

## Parameters

**datasetId** `string` *required*

Dataset ID with prefix `ds.`.

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

Maximum number of results to return; defaults to 20.

**offset** `number` (default: 0)

Number of results to skip before this page; defaults to 0.

## Returns

`Promise<{ slices: DatasetSlice[]; pagination: Pagination }>`

**slices** `DatasetSlice[]` *required*

Dataset slices in this page.

**Fields**

**id** `string` *required*

Slice id. The same id always selects the same rows with the same frozen values.

**datasetId** `string` *required*

ID of the dataset containing this slice, with prefix `ds.`.

**name** `string` *required*

The name that tells this slice apart.

**itemFilter** `object | null` *required*

The filter the rows matched when the slice was taken; null for every row.

See the [HTTP endpoint](https://docs.platform.toloka.ai/docs/api-reference/datasets/list-dataset-slices.md) for the complete schema.

**frozenFieldIds** `string[]` *required*

Fields the slice reads as they were at its cutoff. Other fields read live.

See the [HTTP endpoint](https://docs.platform.toloka.ai/docs/api-reference/datasets/list-dataset-slices.md) for the complete schema.

**fromSliceId** `string | null` *required*

The slice this one was taken from, if any.

**status** `"creating" | "ready" | "failed"` *required*

Only a ready slice can select rows.

**rows** `number` *required*

Rows in the slice once it is ready; 0 until then.

**error** `object | null` *required*

Why the slice failed.

See the [HTTP endpoint](https://docs.platform.toloka.ai/docs/api-reference/datasets/list-dataset-slices.md) for the complete schema.

**cutoff** `string` *required*

The moment the slice was taken: its rows and its frozen fields are read as they were just before it.

**createdAt** `string` *required*

When the slice was requested.

**pagination** `Pagination` *required*

Pagination information for this page.

**Fields**

**total** `number` *required*

Total number of matching results.

**limit** `number` *required*

Maximum number of results requested for this page.

**offset** `number` *required*

Number of results skipped before this page.

**hasMore** `boolean` *required*

Whether more matching results follow this page.

## Errors

HTTP errors throw [`PotatoApiError`](https://docs.platform.toloka.ai/docs/sdk/errors). The endpoint documents these error responses:

| Status | Description |
| - | - |
| 404 | Dataset not found |
| 429 | Rate limit exceeded |

HTTP endpoint: [`GET /datasets/{datasetId}/slices`](https://docs.platform.toloka.ai/docs/api-reference/datasets/list-dataset-slices).

```ts listSlicesPage() 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.datasets.listSlicesPage({
  datasetId: "ds.019a0000-0000-7000-8000-000000000001"
});
console.log(page);
```

```json listSlicesPage() theme={null}
{
  "slices": [
    {
      "id": "dsl.019a0000-0000-7000-8000-000000000001",
      "datasetId": "ds.019a0000-0000-7000-8000-000000000001",
      "name": "<string>",
      "itemFilter": null,
      "frozenFieldIds": [
        "df.019a0000-0000-7000-8000-000000000001"
      ],
      "fromSliceId": null,
      "status": "creating",
      "rows": 0,
      "error": null,
      "cutoff": "2026-01-01T00:00:00Z",
      "createdAt": "2026-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}
```


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