---
title: "Get run timeline"
method: GET
path: "/v1/runs/{id}/timeline"
tags: ["Runs"]
---

# Get run timeline

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

Get a comprehensive timeline view of an agent run including:
- Full event history with retry chain tracking
- Anomaly detection and alerts
- Human-readable explanations
- Summary statistics
- Pagination for large runs

This is THE killer feature for debugging what happened in an agent execution.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `cursor` string
- `includeAnomalies` boolean
- `collapseRetries` boolean

## Response `200`

Run timeline with events, anomalies, and summary

- object — Run timeline with events, anomalies, and summary
  - `runId` string
  - `workflowId` string, nullable
  - `workflowName` string, nullable
  - `customerId` string
  - `status` string
  - `correlationId` string, nullable
  - `metadata` object, nullable
  - `errorMessage` string, nullable
  - `errorCode` string, nullable
  - `startedAt` string, date-time, nullable
  - `endedAt` string, date-time, nullable
  - `durationMs` integer, nullable
  - `events` object[]
    - `id` string
    - `eventType` string
    - `actionName` string, nullable
    - `outcome` 'SUCCESS' | 'FAILED' | 'PENDING' | 'TIMEOUT' | 'RETRYING'
    - `explanation` string, nullable
    - `description` string, nullable
    - `timestamp` string, date-time
    - `durationMs` integer, nullable
    - `parentEventId` string, nullable
    - `retryOfEventId` string, nullable
    - `attemptNumber` integer
    - `retriedByEventId` string, nullable
    - `costUsdc` string, nullable
    - `isRetry` boolean
    - `retryChain` object, nullable
      - `totalAttempts` integer
      - `finalOutcome` string
      - `events` string[]
    - `metadata` object, nullable
      - `usageType` string
      - `quantity` number
      - `units` string, nullable
  - `anomalies` object[]
    - `id` string
    - `type` string
    - `severity` 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL'
    - `title` string
    - `explanation` string
    - `relatedEventIds` string[]
    - `detectedAt` string, date-time
    - `status` 'OPEN' | 'INVESTIGATING' | 'RESOLVED' | 'FALSE_POSITIVE' | 'IGNORED'
  - `summary` object
    - `totalEvents` integer
    - `byType` object
    - `byOutcome` object
    - `retriedEvents` integer
    - `failedEvents` integer
    - `totalCostUsdc` string, nullable
  - `hasMore` boolean
  - `nextCursor` string, nullable

## Other responses

- `401` — Unauthorized
- `404` — Run not found

---

[API](https://skmtc.net/usedrip/apis/drip-api.md) · [All operations](https://skmtc.net/usedrip/apis/drip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usedrip/drip-api/versions/2cb1567969ca/schema)