client.datasets.listSlicesPage()

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);

{
  "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
  }
}

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);

{
  "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
  }
}

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

Signature

Method signature on client.datasets:

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

Parameters

string

required

Dataset ID with prefix ds..

number

default:"20"

Maximum number of results to return; defaults to 20.

number

default:"0"

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

Returns

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

DatasetSlice[]

required

Dataset slices in this page.

Show Fields

string

required

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

string

required

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

string

required

The name that tells this slice apart.

object | null

required

The filter the rows matched when the slice was taken; null for every row.See the HTTP endpoint for the complete schema.

string[]

required

Fields the slice reads as they were at its cutoff. Other fields read live.See the HTTP endpoint for the complete schema.

string | null

required

The slice this one was taken from, if any.

"creating" | "ready" | "failed"

required

Only a ready slice can select rows.

number

required

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

object | null

required

Why the slice failed.See the HTTP endpoint for the complete schema.

string

required

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

string

required

When the slice was requested.

Pagination

required

Pagination information for this page.

Show Fields

number

required

Total number of matching results.

number

required

Maximum number of results requested for this page.

number

required

Number of results skipped before this page.

boolean

required

Whether more matching results follow this page.

Errors

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

Status	Description
404	Dataset not found
429	Rate limit exceeded

HTTP endpoint: GET /datasets/{datasetId}/slices.

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);

{
  "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
  }
}

Reference

TypeScript SDK

CLI

HTTP API

client.datasets.listSlicesPage()

Signature

Parameters

Returns

Errors

​Signature

​Parameters

​Returns

​Errors

Signature

Parameters

Returns

Errors