GET
Get Conversation Snapshot

Authorizations

Authorization
string
header
required

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

Path Parameters

conversation_id
string<uuid>
required

Response

Successful Response

The band at the top of the call and conversation views.

agent_became_ready
boolean
default:false
required
agent_messages
integer
default:0
required
billing_status
string
default:pending
required
cached_input_tokens
integer
default:0
required
connection
ConnectionQuality · object
required

The worst reading on each side of the call, kept apart on purpose.

A collapsed "the connection was poor" reads as a platform fault even when the poor leg was the caller's own network, which is the difference between a support ticket and a shrug. overall stays for readers that only want one word; agent and caller are unknown on calls whose trace predates the side field.

connection_quality
string
default:unknown
required
duration_seconds
integer | null
required
end_of_turn_avg_ms
number | null
required
errors
integer
default:0
required
false_interruptions
integer
default:0
required
false_interruptions_resumed
integer
default:0
required
input_tokens
integer
default:0
required
interruptions
integer
default:0
required
issues
string[]
required
noise_cancellation_failed
boolean
default:false
required
ok
boolean
default:true
required
output_tokens
integer
default:0
required
pace
PaceStats · object
required

How the call sounded, as opposed to how fast the stack was.

Derived from started_speaking_at / stopped_speaking_at, which LiveKit puts on every message and nothing has ever read. None of it is a platform defect — a long reply is the prompt's doing and a long silence is often the caller thinking — which is why it lands here as numbers rather than in issues.

provider_failures
integer
default:0
required
provider_recoveries
integer
default:0
required
providers
string[]
required
response_latency
LatencyStats · object
required
slow_response_threshold_ms
number
default:3500
required
slow_tool_calls
integer
default:0
required
slow_tool_calls_in_silence
integer
default:0
required
slow_tool_threshold_ms
number
default:8000
required
stt_audio_ms
integer
default:0
required
tool_call_failures
integer
default:0
required
tool_calls
integer
default:0
required
total_audio_ms
integer
default:0
required
total_cost_usd
number | null
required
transcription_avg_ms
number | null
required
ttfb_avg_ms
number | null
required
ttft_avg_ms
number | null
required
tts_audio_ms
integer
default:0
required
tts_characters
integer
default:0
required
turns
integer
default:0
required
unfinished_tool_calls
integer
default:0
required
uninterrupted_responses
integer
default:0
required
user_messages
integer
default:0
required