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

# GET /datasets/{datasetId}/examples

`GET /datasets/{datasetId}/examples`

Returns paginated examples from the dataset. The server embeds the resolved version in the pagination token. Once pagination begins, all subsequent pages are pinned to that version regardless of concurrent mutations.

## Path parameters

- `datasetId` string, required

## Query parameters

- `datasetVersion` string — Dataset version identifier. Accepts "DRAFT" or a non-negative integer string representing a published version number.
- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListDatasetExamplesResponse
  - `datasetArn` string, required — The Amazon Resource Name (ARN) of the dataset.
  - `datasetId` string, required — The unique identifier of the dataset.
  - `datasetVersion` string, required — The version returned.
  - `examples` SensitiveJson[], required — Paginated example content. Each element is a JSON object containing at least an <code>exampleId</code> field plus the schema-specific content fields.
  - `nextToken` string — The token for the next page of results, or null if there are no more results.

## Other responses

- `480` — ValidationException
- `481` — ConflictException
- `482` — AccessDeniedException
- `483` — ResourceNotFoundException
- `484` — ThrottlingException
- `485` — 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)