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

# List dataset versions

`GET /v1/datasets-v2/{datasetId}/versions`

## Request

- Base URL: `https://api.lunary.ai`
- URL: `https://api.lunary.ai/v1/datasets-v2/{datasetId}/versions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lunary/apis/lunary-api/docs/v1/datasets-v2/:datasetId/versions/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `datasetId` string, uuid, required

## Query parameters

- `limit` integer

## Response `200`

Dataset versions

- object
  - `versions` DatasetV2Version[]
    - `id` string, uuid
    - `datasetId` string, uuid
    - `versionNumber` integer
    - `createdAt` string, date-time
    - `createdBy` string, uuid, nullable
    - `restoredFromVersionId` string, uuid, nullable
    - `name` string, nullable
    - `description` string, nullable
    - `itemCount` integer

---

[API](https://skmtc.dev/lunary/apis/lunary-api.md) - [All operations](https://skmtc.dev/lunary/apis/lunary-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lunary/apis/lunary-api/revisions/a38233713bdc?raw)