---
title: "List Evaluation Runs"
method: GET
path: "/eval-runs"
tags: ["Evals"]
---

# List Evaluation Runs

`GET /eval-runs`

Retrieve paginated evaluation runs with filtering and sorting options. Filter by agent, team, workflow, model, or evaluation type.

## Query parameters

- `agent_id` string, nullable — Agent ID
- `team_id` string, nullable — Team ID
- `workflow_id` string, nullable — Workflow ID
- `model_id` string, nullable — Model ID
- `type` 'agent' | 'team' | 'workflow'
- `limit` integer, nullable — Number of eval runs to return
- `page` integer, nullable — Page number
- `sort_by` string, nullable — Field to sort by
- `sort_order` 'asc' | 'desc'
- `db_id` string, nullable — The ID of the database to use
- `table` string, nullable — The database table to use
- `eval_types` string, nullable — Comma-separated eval types (accuracy,agent_as_judge,performance,reliability)

## Response `200`

Evaluation runs retrieved successfully

- PaginatedResponseEvalSchema
  - `data` EvalSchema[], required — List of items for the current page
    - `id` string, required — Unique identifier for the evaluation run
    - `agent_id` string, nullable — Agent ID that was evaluated
    - `model_id` string, nullable — Model ID used in evaluation
    - `model_provider` string, nullable — Model provider name
    - `team_id` string, nullable — Team ID that was evaluated
    - `workflow_id` string, nullable — Workflow ID that was evaluated
    - `name` string, nullable — Name of the evaluation run
    - `evaluated_component_name` string, nullable — Name of the evaluated component
    - `eval_type` 'accuracy' | 'agent_as_judge' | 'performance' | 'reliability', required
    - `eval_data` object, required — Evaluation results and metrics
    - `eval_input` object, nullable — Input parameters used for the evaluation
    - `created_at` string, date-time, nullable — Timestamp when evaluation was created
    - `updated_at` string, date-time, nullable — Timestamp when evaluation was last updated
  - `meta` PaginationInfo, required
    - `page` integer — Current page number (0-indexed)
    - `limit` integer — Number of items per page
    - `total_pages` integer — Total number of pages
    - `total_count` integer — Total count of items
    - `search_time_ms` number — Search execution time in milliseconds

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/agno/apis/agno-api-reference.md) · [All operations](https://skmtc.net/agno/apis/agno-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agno/agno-api-reference/versions/5f6149d395d0/schema)