Skip to main content
GET
Fetch a call with its trace

Authorizations

Authorization
string
header
required

Tenant API key (vdx_live_…) as Authorization: Bearer.

Path Parameters

id
string
required
Pattern: ^[a-zA-Z0-9-_+]+$

Response

The call.

id
string
status
string
error
string
direction
string
fromNumber
string
toNumber
string
assistantName
string
startedAt
integer<int64>

Epoch ms.

durationMs
integer
callStatus
enum<string>

Where a call is in its life.

Available options:
queued,
dialing,
ringing,
in_progress,
on_hold,
transferring,
completed,
transferred,
no_answer,
busy,
voicemail_detected,
invalid_number,
no_response,
failed,
dropped_by_caller,
dropped_by_agent,
cancelled
statusGroup
enum<string>
Available options:
pre_connect,
active,
ended_success,
ended_no_connect,
ended_issue
statusAt
integer<int64>

Epoch ms.

endReason
string
payments
object[]

Every payment attempt the call made, oldest first. Empty for a call that took no payment.

statusHistory
object[]

Every status the call has been in, oldest first.

events
object[]

The worker's JSONL trace, one object per line: call-meta, config-effective, per-turn records (with derived.ttfaMs and text), recording, call-end. Empty when the call failed before an agent joined.

recordingUrl
string | null
Example:

"/v1/recordings/call-…"