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

# Evaluation Run List

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

## Request

- Base URL: `https://trace.wandb.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://trace.wandb.ai/v2/{entity}/{project}/evaluation_runs`
- Auth: none declared

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-10-16** `dd89fadfe4e4`: 1 breaking, 11 info
  - the response's body type changed from `array` to `object` for status `200`
  - the endpoint scheme security `HTTPBasic` was removed from the API
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
  - …8 more
- **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 changed from `object` to no type 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

[Operation history](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api/changes/v2/:entity/:project/evaluation_runs/get.md)

---

[API](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api.md) - [All operations](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api/revisions/f7643c49bf2e?raw)
