Get Conversation Traces

GET

https://api.speechify.ai/v1/agents/conversations/:id/traces

GET

/v1/agents/conversations/:id/traces

$ curl https://api.speechify.ai/v1/agents/conversations/id/traces \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

1 {
2   "turns": [
3     {
4       "index": 1,
5       "start_offset_ms": 1500,
6       "e2e_ms": 1200.5,
7       "stt_ms": 350.2,
8       "eou_ms": 100.3,
9       "llm_ttft_ms": 450,
10       "tts_ttfb_ms": 300,
11       "llm_model": "gpt-4-voice-agent-v1",
12       "llm_provider": "openai",
13       "llm_fallback": false,
14       "events": [
15         {
16           "kind": "tool",
17           "offset_ms": 1800,
18           "name": "sentiment-analysis",
19           "duration_ms": 250.7,
20           "is_error": false
21         }
22       ]
23     },
24     {
25       "index": 2,
26       "start_offset_ms": 5000,
27       "e2e_ms": 1100,
28       "stt_ms": 300,
29       "eou_ms": 90,
30       "llm_ttft_ms": 400,
31       "tts_ttfb_ms": 310,
32       "llm_model": "gpt-4-voice-agent-v1",
33       "llm_provider": "openai",
34       "llm_fallback": false,
35       "events": [
36         {
37           "kind": "dtmf",
38           "offset_ms": 5200,
39           "name": "",
40           "duration_ms": 50,
41           "is_error": false
42         }
43       ]
44     }
45   ],
46   "first_response_ms": 1700,
47   "end_reason": "caller_hangup"
48 }

Retrieve the per-call trace timeline for a conversation: the worker pipeline spans (STT, end-of-turn, LLM, TTS, tool calls, DTMF) in call order, each with its start offset from the beginning of the call and its duration, for rendering a latency waterfall. Returns an empty timeline for a call that never connected.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Path parameters

idstringRequired

Response

The per-call trace timeline.

turnslist of objects

first_response_msdouble

Milliseconds to the agent’s first audio (greeting / first reply). Absent when the agent never started speaking.

end_reasonstring

How the call ended (e.g. caller_hangup), surfaced even when there are no completed turns.

Errors

401

Unauthorized Error

404

Not Found Error

503

Service Unavailable Error