---
title: "GET /v1/agents/{agent_id}/runs"
method: GET
path: "/v1/agents/{agent_id}/runs"
tags: ["runs"]
---

# GET /v1/agents/{agent_id}/runs

`GET /v1/agents/{agent_id}/runs`

## Path parameters

- `agent_id` string, uuid, required

## Query parameters

- `page` integer
- `page_size` integer
- `filter_user_email` string, nullable
- `filter_goal` string, nullable
- `filter_status` string, nullable
- `filter_run_id` string, nullable
- `filter_started_after` string, nullable
- `filter_started_before` string, nullable
- `filter_policy_type` string, nullable
- `filter_policy_group` string, nullable

## Response `200`

- ListRunsResponse
  - `all_run_summaries` RunSummary[], required
    - `attention_reason` string, nullable
    - `credits_consumed` integer, nullable
    - `is_finished` boolean, required
    - `is_paused` boolean, required
    - `outcome` string, nullable
    - `policy_model` string, nullable
    - `policy_type` string, nullable
    - `run_id` string, required
    - `run_kind` string, nullable
    - `run_number` integer, required
    - `run_phase` string, nullable
    - `schedule_agent_id` string, nullable
    - `started_at` string, required
    - `summary` string, nullable
    - `title` string, nullable
    - `tool_icons` ToolIcon[], required
      - `action_type` string, required
      - `favicon_url` string, nullable
      - `icon` string, nullable
    - `total_action_count` integer, required
    - `trigger_kind` string, nullable
    - `webhook_subscription_id` string, nullable
    - `wrote_instructions` boolean, nullable
  - `page` integer, required
  - `page_size` integer, required
  - `runs` Run[], required
    - `agent_id` string, required
    - `event_bytes` integer, required
    - `event_count` integer, required
    - `goal` string, nullable
    - `is_finished` boolean, required
    - `last_event_at` string, required
    - `policy_model` string, nullable
    - `policy_type` string, nullable
    - `run_id` string, required
    - `run_kind` string, nullable
    - `run_number` integer, required
    - `schedule_agent_id` string, nullable
    - `started_at` string, required
    - `status` string, nullable
    - `step_count` integer, required
    - `user_email` string, nullable
    - `user_id` string, nullable
    - `webhook_subscription_id` string, nullable
    - `wrote_instructions` boolean, nullable
  - `total_runs` integer, required

## Other responses

- `404`

---

[API](https://skmtc.net/twin/apis/twin-api.md) · [All operations](https://skmtc.net/twin/apis/twin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twin/twin-api/revisions/a674e57c2ec4/schema)