Skip to main content
GET
Get Call Spans

Authorizations

Authorization
string
header
required

Use Tuner API key (tr_api_...) or user session token. Find your API key in Workspace Settings > API Keys.

Path Parameters

call_id
integer
required

Tuner's internal numeric ID for the call.

agent_id
integer
required

Tuner's internal numeric ID for the agent.

workspace_id
integer
required

Workspace ID. Find this in Workspace > General Settings.

Response

Successful Response

span_id
string
required

This span's id, hex

trace_id
string
required

Id of the trace this span belongs to, hex

name
string
required

Operation name, e.g. 'llm' or 'agent_turn'

start_time
string<date-time>
required

When the operation started

end_time
string<date-time>
required

When the operation finished

status_code
integer
required

OpenTelemetry status: 0 unset, 1 ok, 2 error

parent_span_id
string | null

Owning span's id, hex. Null on the root span.

kind
integer | null

OpenTelemetry span kind

duration_ms
number | null

Duration in milliseconds

status_message
string | null

Status detail, when the span failed

scope_name
string | null

Library that emitted the span

service_name
string | null

Emitting service, e.g. 'livekit-agents'

attributes
Attributes · object

Allowlisted span attributes

resource_attributes
Resource Attributes · object

Allowlisted attributes describing the emitting process