# dataset.listVersions()

**Added in:** `@mastra/core@1.4.0`

Lists all versions of the dataset with pagination.

## Usage example

```typescript
import { Mastra } from "@mastra/core";

const mastra = new Mastra({ /* storage config */ });

const dataset = await mastra.datasets.get({ id: "dataset-id" });

const { versions, pagination } = await dataset.listVersions({ page: 0, perPage: 10 });

for (const version of versions) {
  console.log(`Version ${version.version} created at ${version.createdAt}`);
}
```

## Parameters

**page?:** (`number`): Page number. Defaults to \`0\`.

**perPage?:** (`number`): Number of versions per page. Defaults to \`20\`.

## Returns

**result:** (`Promise<object>`): objectversions:DatasetVersion\[]Array of version records.DatasetVersionid:stringUnique identifier of the version record.datasetId:stringID of the parent dataset.version:numberVersion number.createdAt:DateWhen this version was created.pagination:objectPagination metadata.objecttotal:numberTotal number of versions.page:numberCurrent page number.perPage:number | falseVersions per page, or \`false\` if unpaginated.hasMore:booleanWhether more pages are available.