---
title: "List Agent Runs"
method: GET
path: "/api/agent-runs"
tags: ["agent-runs"]
---

# List Agent Runs

`GET /api/agent-runs`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/agent-runs`
- Auth: none declared

## Query parameters

- `state` 'active' | 'waiting' | 'failed' | 'completed' | 'all'
- `limit` integer
- `fanout_limit` integer
- `agent_identity_id` string, uuid, nullable

## Headers

- `x-impersonate-identity-id` string, nullable

## Response `200`

Successful Response

- AgentRunsResponse
  - `groups` AgentRunGroupResponse[], required
    - `group_key` string, required
    - `supervising_agent_id` string, uuid, required
    - `supervising_agent_name` string, nullable, required
    - `runtime_environment_ref` string, nullable, required
    - `open_count` integer, required
    - `total_count` integer, required
    - `runs` AgentRunSummaryResponse[], required
      - `id` string, uuid, required
      - `display_title` string, required
      - `origin` string, required
      - `supervising_agent_id` string, uuid, required
      - `supervising_agent_name` string, nullable, required
      - `runtime_kind` string, required
      - `runtime_environment_ref` string, nullable, required
      - `status` string, required
      - `supervision_status` string, required
      - `state` 'active' | 'waiting' | 'failed' | 'completed' | 'all', required
      - `activity_state` 'active' | 'recent', required
      - `last_activity_at` string, required
      - `artifact_count` integer, required
      - `transcript_chat_id` string, uuid, required
      - `transcript_chat_title` string, required
      - `created_at` string, required
      - `completed_at` string, nullable, required
      - `progress` object, nullable
      - `outcome` 'stopped_unfinished' | 'continued', nullable
  - `total_count` integer, required
  - `fanouts` FanoutSummaryResponse[], required
    - `fanout_id` string, uuid, required
    - `label` string, nullable, required
    - `agent_identity_id` string, uuid, required
    - `agent_name` string, nullable, required
    - `parent_chat_id` string, uuid, nullable, required
    - `total` integer, required
    - `done` integer, required
    - `pending` integer, required
    - `running` integer, required
    - `succeeded` integer, required
    - `failed` integer, required
    - `canceled` integer, required
    - `other` integer, required
    - `counts_by_status` object, required
    - `max_concurrency` integer, nullable, required
    - `first_error` string, nullable, required
    - `complete` boolean, required
    - `cancelable` boolean, required
    - `activity_state` 'active' | 'recent', required
    - `created_at` string, required
    - `last_activity_at` string, required

## Other responses

- `422`: Validation Error

---

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