List Traces
Retrieve a paginated list of execution traces with optional filtering.
Traces provide observability into:
- Agent execution flows
- Model invocations and token usage
- Tool calls and their results
- Errors and performance bottlenecks
Filtering Options:
- By run, session, user, or agent ID
- By status (OK, ERROR)
- By time range
Pagination:
- Use
page(1-indexed) andlimitparameters - Response includes pagination metadata (total_pages, total_count, etc.)
Response Format:
Returns summary information for each trace. Use GET /traces/{trace_id} for detailed hierarchy.
Documentation Index
Fetch the complete documentation index at: https://docs.agno.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Filter by run ID
Filter by session ID
Filter by user ID
Filter by agent ID
Filter by team ID
Filter by workflow ID
Filter by status (OK, ERROR)
Filter traces starting after this time (ISO 8601 format with timezone, e.g., '2025-11-19T10:00:00Z' or '2025-11-19T15:30:00+05:30'). Times are converted to UTC for comparison.
Filter traces ending before this time (ISO 8601 format with timezone, e.g., '2025-11-19T11:00:00Z' or '2025-11-19T16:30:00+05:30'). Times are converted to UTC for comparison.
Page number (1-indexed)
x >= 0Number of traces per page
x >= 1Database ID to query traces from