---
title: "List a deep agent's run history"
method: GET
path: "/v1/agent-runs/history"
tags: ["agent-runs"]
---

# List a deep agent's run history

`GET /v1/agent-runs/history`

Returns the org-scoped run history for one deep agent (by
`agentType`) — the audit trail of what was run: prompt, status,
turns, token usage, cost, and a link to the served report when one
was produced. Newest-first.

## Query parameters

- `agentType` string, required
- `limit` integer
- `offset` integer

## Response `200`

OK

- ListAgentRunHistorySuccessResponse
  - `code` integer
  - `data` PaginatedDataAgentRunHistoryItem
    - `hasMore` boolean
    - `items` AgentRunHistoryItem[]
      - `agentType` string
      - `completionTokens` integer
      - `costUsd` number
      - `createdAt` string
      - `detail` string
      - `finishedAt` string
      - `prompt` string
      - `promptTokens` integer
      - `runId` string
      - `servedUrl` string — ServedURL is the absolute, browser-openable address of the served report, empty when the run served no artifact (or the worker base is unconfigured).
      - `status` string
      - `turns` integer
      - `usageModel` string
      - `userId` string
    - `limit` integer
    - `offset` integer
  - `message` string
  - `requestId` string

---

[API](https://skmtc.dev/b3os/apis/b3os-workflow-api.md) · [All operations](https://skmtc.dev/b3os/apis/b3os-workflow-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/b3os/b3os-workflow-api/revisions/a8c7af3c66a1/schema)