---
title: "List dataset versions"
method: GET
path: "/v1/datasets/{id}/versions"
tags: ["datasets"]
---

# List dataset versions

`GET /v1/datasets/{id}/versions`

## Path parameters

- `id` string, required — The ID of the dataset

## Query parameters

- `cursor` string, nullable — Cursor for pagination
- `limit` integer — The max number of dataset versions to return at a time

## Response `200`

Successful Response

- ListDatasetVersionsResponseBody
  - `data` DatasetVersion[], required
    - `version_id` string, required
    - `description` string, nullable, required
    - `metadata` object, required
    - `created_at` string, date-time, required
  - `next_cursor` string, nullable, required

## Other responses

- `403` — Forbidden
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/arize-ai/apis/arize-phoenix-rest-api.md) · [All operations](https://skmtc.net/arize-ai/apis/arize-phoenix-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arize-ai/arize-phoenix-rest-api/revisions/d61b825a4bb4/schema)