---
title: "List dataset examples"
method: GET
path: "/v2/datasets/{dataset_id}/examples"
tags: ["Datasets"]
---

# List dataset examples

`GET /v2/datasets/{dataset_id}/examples`

List examples for a given dataset and version.

If version is not passed, the latest version is selected. Examples are
returned in ascending order of `created_at`, with `id` as a tiebreaker.
This order is stable across pages, so cursor pagination never skips or
repeats an example.

**Human annotations**: returned in the structured `annotations` array on
each example. Each entry includes `name`, optional `label` / `score` /
`text` / `updated_at`, and an `annotator` (id + email) for per-user
annotations.

**Pagination**:
- Response includes `pagination` with `has_more` and `next_cursor`.
- Use cursor-based pagination by passing the returned `next_cursor`
value as the `cursor` query parameter in subsequent requests.

<Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note>

## Path parameters

- `dataset_id` string, required — A universally unique identifier (base64-encoded opaque string).

## Query parameters

- `dataset_version_id` string — A universally unique identifier (base64-encoded opaque string).
- `limit` integer
- `cursor` string

## Response `200`

Returns a list of dataset examples as structured objects

- ListDatasetExamplesResponse
  - `examples` DatasetExample[], required — Array of example objects from the dataset
    - `id` string, required — System-assigned unique ID for the example
    - `created_at` string, date-time, required — Timestamp for when the example was created
    - `updated_at` string, date-time, required — Timestamp for the last update of the example
    - `annotations` Annotation[] — List of human annotations on this dataset example
      - `name` string, required — The name of the annotation
      - `score` number, double — Numeric score for the annotation
      - `label` string — Categorical label for the annotation
      - `text` string — Free-form text note for the annotation
      - `updated_at` string, date-time — Timestamp when the annotation was last updated
      - `annotator` AnnotatorUser — A user assigned as an annotator, identified by ID and email.
        - `id` string, required — The unique identifier for the user
        - `email` string, email, required — An email address
  - `pagination` PaginationMetadata, required — Cursor-based pagination metadata. Use `next_cursor` in the subsequent request's `cursor` query parameter.
    - `next_cursor` string — Opaque cursor for fetching the next page. Treat as an unreadable token. Present when `has_more` is true; omitted when `has_more` is false.
    - `has_more` boolean, required — True if another page of results is available.

## Other responses

- `400` — Invalid request
- `401` — Authentication is required
- `403` — Insufficient permissions to access this resource
- `404` — Not found
- `429` — Rate limit exceeded

---

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