---
title: "List Runs"
method: GET
path: "/v2/teams/{teamId}/runs"
tags: ["Runs"]
---

# List Runs

`GET /v2/teams/{teamId}/runs`

## Request

- Base URL: `https://api.duvo.ai`
- URL: `https://api.duvo.ai/v2/teams/{teamId}/runs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/duvo/apis/duvo-public-api/docs/v2/teams/:teamId/runs/get.ts> (a function with typed inputs; its response is checked against the schema)

List runs for the current team. Supports filtering by agent, user, queue, status, etc. Messages, evaluation data, and queue metadata are included where available.

## Path parameters

- `teamId` string, required

## Query parameters

- `limit` number
- `offset` number
- `sort_by` 'created_at'
- `sort_order` 'asc' | 'desc'
- `status` 'not_started' | 'pending' | 'starting' | 'running' | 'waiting' | 'completed' | 'failed' | 'interrupted' | 'stopped' | 'needs_attention'
- `agent_id` string, uuid
- `user_id` string, uuid
- `case_queue_id` string, uuid
- `source` string
- `search` string
- `has_issues` 'true' | 'false'
- `issue_severity` 'critical' | 'medium' | 'low'
- `since` string, date-time
- `digest_id` string, uuid

## Response `200`

Default Response

- object
  - `data` object[], required
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `started_at` string, date-time, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `status` 'not_started' | 'pending' | 'starting' | 'running' | 'waiting' | 'completed' | 'failed' | 'interrupted', required
    - `source` string, nullable, required
    - `title` string, required
    - `run_number` number, required
    - `agent_id` string, uuid, required
    - `agent_name` string, required
    - `build_id` string, uuid, required
    - `user_id` string, uuid, nullable, required
    - `case_queue_item_id` string, uuid, nullable, required
    - `case_queue_id` string, uuid, nullable, required
    - `case_queue_name` string, nullable, required
    - `case_title` string, nullable, required
    - `postponed_to` string, date-time, nullable, required
    - `submitted_prompt_count` integer, required
    - `eval_summaries` object, nullable
      - `passed` number, required
      - `total` number, required
      - `final_comment` string
      - `status` 'ready' | 'unavailable' | 'in_progress', required
      - `severityCounts` object
        - `critical` integer, required
        - `medium` integer, required
        - `low` integer, required
  - `total` number, required

## Other responses

- `400`: Default Response
- `401`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/duvo/apis/duvo-public-api.md) - [All operations](https://skmtc.dev/duvo/apis/duvo-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duvo/apis/duvo-public-api/revisions/dafcf3d868a9?raw)