Skip to main content
GET
Get trace

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

trace_id
string
required

Trace ID.

Query Parameters

expand
enum<string>

Optional expansion. Omit for the default detail payload; context returns the agent context bundle.

Available options:
context
project_id
string

Project ID. Required when expand=context.

spans_limit
integer

With expand=context: maximum spans in the bundle (max 500).

Required range: 1 <= x <= 500
spans_offset
integer

With expand=context: number of spans to skip.

Required range: x >= 0
include_attributes
boolean

With expand=context: include span attributes (default true).

include_events
boolean

With expand=context: include span events (default true).

Response

Trace details

id
string
required
otel_trace_id
string
required
project_id
string
required
service_name
string | null
required
agent_name
string | null
required
thread_id
string | null
required
thread_trace_count
number | null
required
agent_input_display
string | null
required
tool_calls
object[]
required
interaction
object
required
has_error
boolean
required
total_duration_ms
number | null
required
timestamp
string<date-time>
required
spans
object[]
required
stats
object
required
issue_extraction
object | null
required
project_name
string
agent_input
null
agent_output
null
release
string | null