Skip to main content
GET
/
api
/
v1
/
sessions
List Sessions
curl --request GET \
  --url http://localhost:8000/api/v1/sessions
[
  {
    "trace_id": "abc123def456789012345678",
    "start_time": "2026-03-17T14:20:00Z",
    "end_time": "2026-03-17T14:20:03.5Z",
    "total_duration_ns": 3500000000,
    "span_count": 12,
    "root_span_name": "AgentExecutor",
    "root_span_id": "span123",
    "agent_name": "Researcher",
    "has_error": false
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.tracectrl.ai/llms.txt

Use this file to discover all available pages before exploring further.

Returns the most recent 200 traces, each summarized with root span info, agent name, span count, duration, and error status.

​
Query Parameters

​
service
string
Filter sessions by service name.

​
Response

Array of session summary objects:
​
trace_id
string
OpenTelemetry trace ID
​
start_time
string
ISO-8601 timestamp of first span
​
end_time
string
ISO-8601 timestamp of last span end
​
total_duration_ns
integer
Wall-clock trace duration in nanoseconds
​
span_count
integer
Number of spans in this trace
​
root_span_name
string
Name of the root span (entry point)
​
root_span_id
string
Span ID of the root span
​
agent_name
string
Primary agent name (first agent seen in trace)
​
has_error
boolean
true if any span in the trace has an error status
[
  {
    "trace_id": "abc123def456789012345678",
    "start_time": "2026-03-17T14:20:00Z",
    "end_time": "2026-03-17T14:20:03.5Z",
    "total_duration_ns": 3500000000,
    "span_count": 12,
    "root_span_name": "AgentExecutor",
    "root_span_id": "span123",
    "agent_name": "Researcher",
    "has_error": false
  }
]