---
title: "Evaluation Run List"
method: GET
path: "/v2/{entity}/{project}/evaluation_runs"
tags: ["Evaluation Runs"]
---

# Evaluation Run List

`GET /v2/{entity}/{project}/evaluation_runs`

List evaluation runs.

## Path parameters

- `entity` string, required
- `project` string, required

## Query parameters

- `evaluations` string[], nullable — Filter by evaluation references
- `models` string[], nullable — Filter by model references
- `evaluation_run_ids` string[], nullable — Filter by evaluation run IDs
- `limit` integer, nullable — Maximum number of evaluation runs to return
- `offset` integer, nullable — Number of evaluation runs to skip

## Response `200`

Stream of data in JSONL format

## Other responses

- `422` — Validation Error

## Changes

- **2026-02-02** `56745769989b` — 1 info
  - endpoint added
- **2026-01-07** `3758bf263a5e` — 1 breaking
  - api path removed without deprecation
- **2026-01-07** `320e24f90749` — 7 info
  - added the optional property `items/finished_at` to the response with the `200` status
  - added the optional property `items/started_at` to the response with the `200` status
  - added the optional property `items/status` to the response with the `200` status
  - added the optional property `items/summary` to the response with the `200` status
  - …3 more
- **2026-01-07** `d6e39f7c717d` — 4 breaking, 4 warning, 4 info
  - the `items/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `items/evaluation` from the response with the `200` status
  - removed the required property `items/evaluation_run_id` from the response with the `200` status
  - removed the required property `items/model` from the response with the `200` status
  - …8 more
- **2025-11-14** `e444bf379e61` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/wandb/apis/fastapi/changes/v2/:entity/:project/evaluation_runs/get.md)

---

[API](https://skmtc.dev/wandb/apis/fastapi.md) · [All operations](https://skmtc.dev/wandb/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wandb/fastapi/revisions/56745769989b/schema)