---
title: "GET /api/v1/dataset-items"
method: GET
path: "/api/v1/dataset-items"
tags: ["Dataset Items"]
---

# GET /api/v1/dataset-items

`GET /api/v1/dataset-items`

Retrieves multiple dataset items.

## Query parameters

- `datasetId` string, required
- `pageNumber` number — The page number.
- `pageSize` number — The page size.
- `search` string — Search term to filter dataset items by name or description.

## Headers

- `authorization` string, required — The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

## Response `200`

Retrieves all dataset items for the workspace.

- object[]
  - `createdAt` string, date-time, required
  - `id` string, uuid, required — A UUID v4 string that identifies an entity.
  - `updatedAt` string, date-time, required
  - `datasetId` string, uuid, required — The dataset ID associated with the dataset item.
  - `description` string, required — The internal description of the dataset item.
  - `file` string, required — The file payload or file reference associated with the dataset item.
  - `name` string, required — The display name of the dataset item.
  - `status` 'pending' | 'processing' | 'completed' | 'failed', required — The processing status of the dataset item.

## Other responses

- `401` — Unauthorized.

---

[API](https://skmtc.dev/zaia/apis/public-api.md) · [All operations](https://skmtc.dev/zaia/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zaia/public-api/revisions/58da3b2ba49f/schema)