client.runs.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.runs.listAllItems({
  runId: "plr.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.runs.listItemsPage({
  runId: "plr.019a0000-0000-7000-8000-000000000001"
});
console.log(page);

{
  "id": "plri.019a0000-0000-7000-8000-000000000001",
  "runId": "plr.019a0000-0000-7000-8000-000000000001",
  "datasetItemId": "di.019a0000-0000-7000-8000-000000000001",
  "index": 0,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z",
  "state": {
    "status": "idle",
    "startedAt": null,
    "finishedAt": null,
    "input": null,
    "output": null,
    "partialOutput": null
  }
}

{
  "items": [
    {
      "id": "plri.019a0000-0000-7000-8000-000000000001",
      "runId": "plr.019a0000-0000-7000-8000-000000000001",
      "datasetItemId": "di.019a0000-0000-7000-8000-000000000001",
      "index": 0,
      "createdAt": "2026-01-01T00:00:00Z",
      "updatedAt": "2026-01-01T00:00:00Z",
      "state": {
        "status": "idle",
        "startedAt": null,
        "finishedAt": null,
        "input": null,
        "output": null,
        "partialOutput": 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.runs.listAllItems({
  runId: "plr.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.runs.listItemsPage({
  runId: "plr.019a0000-0000-7000-8000-000000000001"
});
console.log(page);

{
  "id": "plri.019a0000-0000-7000-8000-000000000001",
  "runId": "plr.019a0000-0000-7000-8000-000000000001",
  "datasetItemId": "di.019a0000-0000-7000-8000-000000000001",
  "index": 0,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z",
  "state": {
    "status": "idle",
    "startedAt": null,
    "finishedAt": null,
    "input": null,
    "output": null,
    "partialOutput": null
  }
}

{
  "items": [
    {
      "id": "plri.019a0000-0000-7000-8000-000000000001",
      "runId": "plr.019a0000-0000-7000-8000-000000000001",
      "datasetItemId": "di.019a0000-0000-7000-8000-000000000001",
      "index": 0,
      "createdAt": "2026-01-01T00:00:00Z",
      "updatedAt": "2026-01-01T00:00:00Z",
      "state": {
        "status": "idle",
        "startedAt": null,
        "finishedAt": null,
        "input": null,
        "output": null,
        "partialOutput": null
      }
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}

Return a page of run items with status and references to input, output, and partial output field revisions. The listAll* variant yields items across every page. The other variant returns one page with pagination metadata. See Pagination.

Signature

Method signatures on client.runs:

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

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

Parameters

listAllItems()

string

required

Pipeline run ID with prefix plr..

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

Pipeline run ID with prefix plr..

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<RunItem> Yields one item at a time. The fields below describe each yielded item. One item processed by a pipeline run.

RunItemId

required

Run item ID with prefix plri..

RunId

required

Pipeline run ID with prefix plr..

DatasetItemId

required

Dataset item ID with prefix di..

number

required

Index of this item within the run.

string

required

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

string

required

Time the run item was last updated, as an ISO 8601 timestamp.

RunItemState

required

The current state and pipeline-level input, output and partial output revision references for a run item.

Show Fields

required

Item state: idle before processing, in_progress while processing, completed, failed, canceled, or paused.

string | null

required

Time processing started, as an ISO 8601 timestamp, or null before it starts.

string | null

required

Time processing ended, as an ISO 8601 timestamp, or null while unfinished.

string | null

Failure message when available; absent or null when no failure message is recorded.

object | null

required

Input field revision IDs selected for this item, or null before inputs are available.

Show Fields

object

required

Dataset field revision IDs keyed by the field IDs used in the pipeline graph.

object | null

required

The End field revisions of a completed item. Null for other statuses.

Show Fields

object

required

Dataset field revision IDs keyed by the field IDs used in the pipeline graph.

object | null

required

For a canceled item, revisions of End-node fields with values at cancellation, including fields passed through from the input. Null for other statuses or when no node wrote an End-node field.

Show Fields

object

required

Dataset field revision IDs keyed by the field IDs used in the pipeline graph.

listItemsPage() result

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

RunItem[]

required

Run items in this page.

Show Fields

RunItemId

required

Run item ID with prefix plri..

RunId

required

Pipeline run ID with prefix plr..

DatasetItemId

required

Dataset item ID with prefix di..

number

required

Index of this item within the run.

string

required

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

string

required

Time the run item was last updated, as an ISO 8601 timestamp.

RunItemState

required

The current state and pipeline-level input, output and partial output revision references for a run item.See the HTTP endpoint for the complete schema.

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	Run not found
429	Rate limit exceeded

HTTP endpoint: GET /runs/{runId}/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.runs.listAllItems({
  runId: "plr.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.runs.listItemsPage({
  runId: "plr.019a0000-0000-7000-8000-000000000001"
});
console.log(page);

{
  "id": "plri.019a0000-0000-7000-8000-000000000001",
  "runId": "plr.019a0000-0000-7000-8000-000000000001",
  "datasetItemId": "di.019a0000-0000-7000-8000-000000000001",
  "index": 0,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z",
  "state": {
    "status": "idle",
    "startedAt": null,
    "finishedAt": null,
    "input": null,
    "output": null,
    "partialOutput": null
  }
}

{
  "items": [
    {
      "id": "plri.019a0000-0000-7000-8000-000000000001",
      "runId": "plr.019a0000-0000-7000-8000-000000000001",
      "datasetItemId": "di.019a0000-0000-7000-8000-000000000001",
      "index": 0,
      "createdAt": "2026-01-01T00:00:00Z",
      "updatedAt": "2026-01-01T00:00:00Z",
      "state": {
        "status": "idle",
        "startedAt": null,
        "finishedAt": null,
        "input": null,
        "output": null,
        "partialOutput": null
      }
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}

Reference

TypeScript SDK

CLI

HTTP API

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