Get Call Spans
Retrieve a call’s OpenTelemetry spans, flat and in start-time order.
Returns an empty list when the call has no trace, which is the common case — whether spans exist depends on how the customer’s agent is instrumented.
Authorizations
Use Tuner API key (tr_api_...) or user session token. Find your API key in Workspace Settings > API Keys.
Path Parameters
Tuner's internal numeric ID for the call.
Tuner's internal numeric ID for the agent.
Workspace ID. Find this in Workspace > General Settings.
Response
Successful Response
This span's id, hex
Id of the trace this span belongs to, hex
Operation name, e.g. 'llm' or 'agent_turn'
When the operation started
When the operation finished
OpenTelemetry status: 0 unset, 1 ok, 2 error
Owning span's id, hex. Null on the root span.
OpenTelemetry span kind
Duration in milliseconds
Status detail, when the span failed
Library that emitted the span
Emitting service, e.g. 'livekit-agents'
Allowlisted span attributes
Allowlisted attributes describing the emitting process