---
title: "List evaluation runs"
method: GET
path: "/agents/runs"
tags: ["agents"]
---

# List evaluation runs

`GET /agents/runs`

## Request

- Base URL: `https://api.mailly.site` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mailly.site/agents/runs`
- Auth: HTTP bearer

Filters: agent_id / status / email_id / thread_id / approval_status; limit defaults to 100, max 200.

## Query parameters

- `agent_id` string
- `status` string
- `email_id` string
- `thread_id` string
- `approval_status` string
- `limit` string

## Response `200`

Run list

- object
  - `success` boolean, required
  - `runs` object[], required

## Other responses

- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/mailly/apis/mailly-api.md) · [All operations](https://skmtc.dev/mailly/apis/mailly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailly/apis/mailly-api/revisions/1ceb29637301?raw)