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

# List datapoints

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

Retrieves a paginated list of datapoints from a specific dataset.

## Path parameters

- `dataset_id` string, required

## Query parameters

- `limit` integer
- `starting_after` string
- `ending_before` string

## Response `200`

OK

- ListDatapointsResponse
  - `object` string, required
  - `data` Datapoint[], required
    - `inputs` object — Structured variables passed to the prompt or workflow.
    - `messages` unknown[] — A JSON array containing dynamically typed values.
      - unknown
    - `expected_output` string — Reference output expected for this datapoint.
    - `evaluations` unknown[] — A JSON array containing dynamically typed values.
      - unknown
    - `dataset_id` string, required — Dataset that owns the datapoint.
    - `snapshot_version` string — Dataset snapshot version that includes the datapoint.
    - `created_by_id` string, required — Account that created the datapoint.
    - `updated_by_id` string, required — Account that last updated the datapoint.
    - `created` string — RFC3339 timestamp when the datapoint was created.
    - `updated` string — RFC3339 timestamp when the datapoint was last updated.
    - `workspace_id` string — Workspace that owns the datapoint, derived from the authentication context.
    - `_id` string, required — Unique datapoint identifier.
  - `has_more` boolean, required

## Changes

> 345 revisions in range; 150 not diffed.

- **2026-09-21** `8f82880fa08a` — 1 breaking, 1 warning, 3 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `data/items/evaluations/items/` response property `oneOf` list for the response status `200`
  - removed the optional property `data/items/messages/items/oneOf[subschema #4: Assistant message]/tool_calls/items/extra_content` from the response with the `200` status
  - the `` response's property default value changed from `2026-09-21T07:21:34.711Z` to `2026-09-21T13:14:17.695Z` for the status `200`
  - the `created` response's property default value changed from `2026-09-21T07:21:34.711Z` to `2026-09-21T13:14:17.695Z` for the status `200`
  - …1 more
- **2026-09-21** `eeb143753ab1` — 1 breaking, 3 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `data/items/evaluations/items/` response property `oneOf` list for the response status `200`
  - the `` response's property default value changed from `2026-09-20T18:42:18.531Z` to `2026-09-21T06:29:15.084Z` for the status `200`
  - the `created` response's property default value changed from `2026-09-20T18:42:18.530Z` to `2026-09-21T06:29:15.083Z` for the status `200`
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `data/items/evaluations/items/` response property `oneOf` list for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/datasets/:dataset_id/datapoints/get.md)

---

[API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.dev/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/orq-ai/apis/orq-ai-api/revisions/3ddbbbd87b26?raw)