client.datasets.listAllItems()

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

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

for await (const item of client.datasets.listAllItems({
  datasetId: "ds.019a0000-0000-7000-8000-000000000001"
})) {
  console.log(item);
}

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

{
  "id": "di.019a0000-0000-7000-8000-000000000001",
  "index": 1,
  "createdAt": "2026-01-01T00:00:00Z",
  "currentSubmissionId": null
}

{
  "items": [
    {
      "id": "di.019a0000-0000-7000-8000-000000000001",
      "index": 1,
      "createdAt": "2026-01-01T00:00:00Z",
      "currentSubmissionId": null
    }
  ],
  "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!,
});

for await (const item of client.datasets.listAllItems({
  datasetId: "ds.019a0000-0000-7000-8000-000000000001"
})) {
  console.log(item);
}

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

{
  "id": "di.019a0000-0000-7000-8000-000000000001",
  "index": 1,
  "createdAt": "2026-01-01T00:00:00Z",
  "currentSubmissionId": null
}

{
  "items": [
    {
      "id": "di.019a0000-0000-7000-8000-000000000001",
      "index": 1,
      "createdAt": "2026-01-01T00:00:00Z",
      "currentSubmissionId": null
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}

Return a page of item IDs, indexes, and creation times, with at most 100 items per page. Field values are available through dataset exports. The listAll* variant yields items across every page. The other variant returns one page with pagination metadata. See Pagination.

Signature

Method signatures on client.datasets:

listAllItems(args: {
  datasetId: string;
  limit?: number;
  offset?: number;
}): AsyncGenerator<DatasetItem>;

listItemsPage(args: {
  datasetId: string;
  limit?: number;
  offset?: number;
}): Promise<{ items: DatasetItem[]; pagination: Pagination }>;

Parameters

listAllItems()

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.

listItemsPage()

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

listAllItems() result

AsyncGenerator<DatasetItem> Yields one item at a time. The fields below describe each yielded item. An item in a dataset.

DatasetItemId

required

Dataset item ID with prefix di..

number

required

One-based position of this item in the dataset.

string

required

Time the dataset item was created, as an ISO 8601 timestamp.

string | null

required

ID of the current submission for this item, or null when it has none.

listItemsPage() result

Promise<{ items: DatasetItem[]; pagination: Pagination }>

DatasetItem[]

required

Run items in this page.

Show Fields

DatasetItemId

required

Dataset item ID with prefix di..

number

required

One-based position of this item in the dataset.

string

required

Time the dataset item was created, as an ISO 8601 timestamp.

string | null

required

ID of the current submission for this item, or null when it has none.

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}/items.

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

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

for await (const item of client.datasets.listAllItems({
  datasetId: "ds.019a0000-0000-7000-8000-000000000001"
})) {
  console.log(item);
}

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

{
  "id": "di.019a0000-0000-7000-8000-000000000001",
  "index": 1,
  "createdAt": "2026-01-01T00:00:00Z",
  "currentSubmissionId": null
}

{
  "items": [
    {
      "id": "di.019a0000-0000-7000-8000-000000000001",
      "index": 1,
      "createdAt": "2026-01-01T00:00:00Z",
      "currentSubmissionId": null
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}

Reference

TypeScript SDK

CLI

HTTP API

client.datasets.listAllItems()

Signature

Parameters

listAllItems()

listItemsPage()

Returns

listAllItems() result

listItemsPage() result

Errors

​Signature

​Parameters

​listAllItems()

​listItemsPage()

​Returns

​listAllItems() result

​listItemsPage() result

​Errors

Signature

Parameters

listAllItems()

listItemsPage()

Returns

listAllItems() result

listItemsPage() result

Errors