---
title: "Agent run history"
method: GET
path: "/v1/agents/{id}/runs"
tags: ["Agents"]
---

# Agent run history

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

## Request

- Base URL: `https://api.marketintell.ai`
- URL: `https://api.marketintell.ai/v1/agents/{id}/runs`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Get the run history of an agent. Each run entry includes started_at, finished_at, status (success/failed/cancelled/skipped), latency_ms, any trade decisions made, and a summary of the reasoning. Default 50 runs, max 200 — for full history, paginate with subsequent calls.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer

## Response `200`

Run history

- object
  - `runs` object[], required
    - `id` string
    - `agent_id` string
    - `started_at` string, date-time
    - `finished_at` string, date-time, nullable
    - `status` 'queued' | 'running' | 'succeeded' | 'failed'
    - `tool_calls` integer
    - `error` string, nullable

---

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