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
  }
]
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
  }
]