---
title: "Get Agent Timeline"
method: GET
path: "/api/ai-agents/{agent_id}/timeline"
tags: ["ai-agents-timeline", "ai-agents-timeline"]
---

# Get Agent Timeline

`GET /api/ai-agents/{agent_id}/timeline`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/ai-agents/{agent_id}/timeline`
- Auth: none declared

Return unified voice/text/skip rows for this agent.

Default window: last 7 days. `from`/`to` override the window.
`mode` filters by row_type. `channel` filters voice/text rows by channel.
`cursor` is the timestamp of the last row from the previous page (ISO).
`include_uninformative` (default False) controls whether skip rows
with all-null payloads are returned. When False (operator's default
view) the rows are filtered out — they carry zero actionable info.
When True the operator can see them under a "show technical events"
toggle for debugging.

## Path parameters

- `agent_id` integer, required

## Query parameters

- `from` string, nullable
- `to` string, nullable
- `mode` 'voice' | 'text' | 'skip', nullable
- `channel` string, nullable
- `channel_account_id` integer, nullable
- `cursor` string, nullable
- `page_size` integer
- `include_uninformative` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)