---
title: "List Evaluation Datasets"
method: GET
path: "/agents/{agent_id}/datasets/evaluate"
tags: ["/agents/{id}/datasets/evaluate"]
---

# List Evaluation Datasets

`GET /agents/{agent_id}/datasets/evaluate`

List all evaluation `Datasets` and their versions belonging to a particular `Agent`.

If a `dataset_name` filter is provided, all versions of that `Dataset` will be listed.

Includes metadata and schema for each `Dataset` version.

## Path parameters

- `agent_id` string, uuid, required — Agent ID for which to list associated evaluation datasets

## Query parameters

- `dataset_name` string — Optional dataset name to filter the results by. If provided, only versions from that dataset are listed.

## Response `200`

Successful Response

- ListDatasetResponse — Response to GET /datasets list endpoint
  - `dataset_summaries` DatasetSummary[], required
    - `name` string, required — Name of the dataset
    - `version` string, required — Version of the dataset
    - `type` 'tuning_set' | 'evaluation_set' | 'evaluation_set_prediction' | 'evaluation_run_result', required
    - `created_at` string, date-time, required — Timestamp indicating when the dataset was created
    - `status` 'validated' | 'validating' | 'failed', required
    - `schema` object, required — Schema of the dataset
    - `num_samples` integer, required — Number of samples in the dataset
  - `total_count` integer, required — Total number of datasets

## Other responses

- `422` — Validation Error

## Changes

- **2025-01-15** `4ed32c3243ce` — 2 info
  - api tag `/agents/{id}/datasets/evaluate` added
  - api tag `/agents/{id}/datasets` removed
- **2025-01-14** `448bcb901d30` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/contextualai/apis/endpoints/changes/agents/:agent_id/datasets/evaluate/get.md)

---

[API](https://skmtc.dev/contextualai/apis/endpoints.md) · [All operations](https://skmtc.dev/contextualai/apis/endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/contextualai/endpoints/revisions/17bdb8a33fb4/schema)