---
title: "List Agent Traces"
method: GET
path: "/api/v1/agents/{agent_id}/traces"
tags: ["Agents"]
---

# List Agent Traces

`GET /api/v1/agents/{agent_id}/traces`

## 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/v1/agents/{agent_id}/traces`
- Auth: none declared

List recent runs of the agent, newest first, with status and duration. Pass a run's id to the run detail endpoint for the full timeline.

## Path parameters

- `agent_id` integer, required

## Query parameters

- `status` string, nullable: pending/executing/completed/failed/cancelled
- `success` boolean, nullable
- `source` string, nullable: agent/auto_reply/agentic/outreach/voice (comma-separable)
- `date_from` string, nullable: ISO-8601 lower bound
- `date_to` string, nullable: ISO-8601 upper bound
- `limit` integer
- `offset` integer

## 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/d84e7dc9977d?raw)