---
title: "Get dataset items"
method: GET
path: "/v1/private/datasets/{id}/items"
tags: ["Datasets"]
---

# Get dataset items

`GET /v1/private/datasets/{id}/items`

Get dataset items

## Path parameters

- `id` string, uuid, required

## Query parameters

- `page` integer
- `size` integer
- `version` string — Version hash or tag to fetch specific dataset version
- `filters` string
- `truncate` boolean — Truncate image included in either input, output or metadata

## Response `200`

Dataset items resource

- DatasetItemPagePublic
  - `content` DatasetItemPublic[]
    - `id` string, uuid — Stable item identifier. On write, used as the upsert key. If omitted, a new ID is generated. Remains the same across dataset versions
    - `dataset_item_id` string, uuid — Deprecated. Always equals 'id'. Retained for backward compatibility and will be removed in a future version
    - `trace_id` string, uuid
    - `span_id` string, uuid
    - `source` 'manual' | 'trace' | 'span' | 'sdk', required
    - `data` JsonNode, required
    - `description` string
    - `tags` string[]
    - `evaluators` EvaluatorItemPublic[]
      - `name` string, required
      - `type` 'llm_judge' | 'code_metric', required
      - `config` JsonNodePublic, required
    - `execution_policy` ExecutionPolicyPublic — Default execution policy for items in this version
      - `runs_per_item` integer
      - `pass_threshold` integer
    - `experiment_items` ExperimentItemPublic[]
      - `id` string, uuid
      - `experiment_id` string, uuid, required
      - `dataset_item_id` string, uuid, required
      - `trace_id` string, uuid, required
      - `project_id` string, uuid
      - `created_at` string, date-time
      - `last_updated_at` string, date-time
      - `created_by` string
      - `last_updated_by` string
      - `trace_visibility_mode` 'default' | 'hidden'
    - `run_summaries_by_experiment` object
    - `dataset_id` string, uuid
    - `created_at` string, date-time
    - `last_updated_at` string, date-time
    - `created_by` string
    - `last_updated_by` string
  - `page` integer
  - `size` integer
  - `total` integer
  - `columns` ColumnPublic[]
    - `name` string
    - `types` string[]
    - `filter_field_prefix` string
    - `filterField` string — The field to use for filtering
  - `sortableBy` string[]

---

[API](https://skmtc.net/comet-ml/apis/opik-rest-api.md) · [All operations](https://skmtc.net/comet-ml/apis/opik-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/comet-ml/opik-rest-api/versions/4ed2fbc97cc3/schema)