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

# List Agent Runs

`GET /agent/runs`

## Request

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

List the signed-in user's durable research runs, newest activity first.

## Query parameters

- `client_run_key` string, nullable: Filter to the run created with this caller-supplied idempotency key -- how an API-key client looks its own run back up by client_run_key after a timeout.

## Response `200`

Successful Response

- AgentRunList
  - `runs` AgentRunSummary[]
    - `id` string, required
    - `status` 'running' | 'completed' | 'failed' | 'interrupted', required
    - `title` string, required
    - `question` string, required
    - `platform` string, nullable
    - `recommendation` string, nullable
    - `model_probability` number, nullable
    - `market_probability` number, nullable
    - `edge` number, nullable
    - `agent_profile` AgentProfileReference: The profile snapshot that shaped one agent report, without private context.
      - `id` string, required
      - `source_agent_id` string, required
      - `model` string, required
      - `version` integer, required
      - `execution_mode` 'research_only', required
    - `has_live_trade_intent` boolean
    - `timeline` AgentRunTimelineEvent[]
      - `at` string, required
      - `phase` string, required
      - `status` 'running' | 'completed' | 'failed' | 'interrupted', required
      - `detail` string, required
    - `created_at` string, required
    - `updated_at` string, required
    - `completed_at` string, nullable
    - `error_code` string, nullable
    - `client_run_key` string, nullable

## Other responses

- `422`: Validation Error

---

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