Skip to main content
Get a call
cost, analysis, and custom_analysis populate after the call ends and post-processing finishes. Subscribe to call.processing.completed to be notified when the complete record is ready. transcript is always included here (unlike the list).

Authorizations

Authorization
string
header
required

Your API key as a Bearer token, e.g. Authorization: Bearer vk_….

Headers

authorization
string | null
X-Vocily-Workspace
string | null
X-Vocily-Org
string | null

Path Parameters

call_id
string
required

Response

Successful Response

A call, as the public API promises it. Curated — see module docstring.

id
string
required
agent_id
string | null
required
status
string
required
direction
string
required
from_number
string | null
required
to_number
string | null
required
duration_seconds
integer | null
required
created_at
string<date-time>
required
connected_at
string<date-time> | null
required
ended_at
string<date-time> | null
required
metadata
Metadata · object | null
required
variables
Variables · object | null
required
cost
PublicCost · object | null
required

A call's cost, explicitly currency-labeled (the internal cost_cents is USD-wallet, so a bare number is ambiguous — this names the currency). total is in major units (USD dollars).

analysis
PublicAnalysis · object | null
required

The platform AI analysis. Same shape as the call.analysis.completed webhook — see app/webhooks/payload_builders.py::_analysis_object; keep the two in lockstep.

custom_analysis
Custom Analysis · object | null
required
transcript
Transcript · object | null
required
recording_url
string | null
required