List dataset items

POST 
/api/v1/evals/list-dataset-items

Lists items in a dataset.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Replay datasets and runs · Dataset identity and run provenance

Request

Responses

200

OK

List items from an existing dataset by name.

Section ID: DOC-IS-evaluation-api-listDatasetItems#example-evals-listDatasetItems-request

Request example

{
  "datasetName": "support-answers",
  "page": 1,
  "pageSize": 20
}

Guide request for 3. Define what an acceptable answer must do. Replace example resource identifiers with your own authorized values.

Section ID: DOC-IS-evaluation-api-listDatasetItems#example-cookbook-insights-evaluation-datasets-and-runs-03-request

Request example

{
  "datasetName": "support-assistant-regressions",
  "onlyMissingExpectedOutput": true
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.

Section ID: DOC-IS-evaluation-api-listDatasetItems#example-evals-listDatasetItems-response

Response example

{
  "items": [
    {
      "itemId": "example_123",
      "datasetId": "example_123",
      "datasetName": "example",
      "inputJson": "{}",
      "expectedOutputJson": "{}",
      "metadataJson": "{}",
      "sourceTraceId": "example_123",
      "sourceObservationId": "example_123",
      "status": "DATASET_ITEM_STATUS_ACTIVE",
      "createdAt": "2026-09-16T12:00:00Z",
      "updatedAt": "2026-09-16T12:00:00Z"
    }
  ],
  "page": {
    "page": 1,
    "limit": 1,
    "totalItems": 1,
    "totalPages": 1
  }
}

Document ID: DOC-IS-evaluation-api-listDatasetItems. Section identities and revisions.

Section	Stable reference
List dataset items	DOC-IS-evaluation-api-listDatasetItems#overview
Request	DOC-IS-evaluation-api-listDatasetItems#request
Responses	DOC-IS-evaluation-api-listDatasetItems#responses