---
title: "GET /datasets/{datasetId}/versions"
method: GET
path: "/datasets/{datasetId}/versions"
---

# GET /datasets/{datasetId}/versions

`GET /datasets/{datasetId}/versions`

Lists all published versions of a dataset, sorted by version number descending (newest first). Does not include the DRAFT working copy.

## Path parameters

- `datasetId` string, required

## Query parameters

- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListDatasetVersionsResponse
  - `versions` DatasetVersionSummary[], required — The list of published dataset versions.
    - `datasetVersion` string, required — The version number of this published snapshot.
    - `exampleCount` integer, required — The number of examples in this version.
    - `createdAt` string, date-time, required — The timestamp when this version was published.
  - `nextToken` string — The token for the next page of results, or null if there are no more results.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — InternalServerException

---

[API](https://skmtc.net/aws/apis/bedrock-agentcore-control.md) · [All operations](https://skmtc.net/aws/apis/bedrock-agentcore-control/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock-agentcore-control/revisions/0ebde766792b/schema)