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

> Get a run item.

Return the item status and references to input, output, and partial output field revisions. Returns 404 if the item does not belong to this run.

## Signature

Method signature on `client.runs`:

```ts theme={null}
getItem(args: {
  runId: string;
  itemId: string;
}): Promise<RunItem>;
```

## Parameters

**runId** `string` *required*

Pipeline run ID with prefix `plr.`.

**itemId** `string` *required*

Run item ID with prefix `plri.`.

## Returns

`Promise<RunItem>`

One item processed by a pipeline run.

**id** `RunItemId` *required*

Run item ID with prefix `plri.`.

**runId** `RunId` *required*

Pipeline run ID with prefix `plr.`.

**datasetItemId** `DatasetItemId` *required*

Dataset item ID with prefix `di.`.

**index** `number` *required*

Index of this item within the run.

**createdAt** `string` *required*

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

**updatedAt** `string` *required*

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

**state** `RunItemState` *required*

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

**Fields**

**status** `"idle" | "in_progress" | "completed" | "failed" | "canceled" | "paused"` *required*

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

**startedAt** `string | null` *required*

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

**finishedAt** `string | null` *required*

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

**error** `string | null`

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

**input** `object | null` *required*

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

**Fields**

**fieldProxyRevisions** `object` *required*

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

**output** `object | null` *required*

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

**Fields**

**fieldProxyRevisions** `object` *required*

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

**partialOutput** `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.

**Fields**

**fieldProxyRevisions** `object` *required*

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

## Errors

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

| Status | Description |
| - | - |
| 404 | Run item not found |
| 429 | Rate limit exceeded |

HTTP endpoint: [`GET /runs/{runId}/items/{itemId}`](https://docs.platform.toloka.ai/docs/api-reference/runs/get-pipeline-run-item).

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

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

const item = await client.runs.getItem({
  runId: "plr.019a0000-0000-7000-8000-000000000001",
  itemId: "plri.019a0000-0000-7000-8000-000000000001"
});
console.log(item);
```

```json getItem() theme={null}
{
  "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
  }
}
```


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