Skip to main content
GET
Get call details

Authorizations

X-API-Key
string
header
required

API key for external access. Format: tp_live_<32-hex-chars>. Create keys in the TalkPilot Dashboard under Settings > API.

Path Parameters

agentId
string<uuid>
required

Agent UUID

callId
string<uuid>
required

Call UUID

Response

Call details

Full call details including transcript and audio URL

id
string<uuid>
call_id
string | null

External call ID (e.g. LiveKit)

customer_name
string | null
customer_request
string | null
phone_number
string | null
duration
integer | null

Call duration in seconds

done
boolean | null
general_success
boolean | null
disconnection_reason
enum<string> | null

busy, no_answer and dial_error occur on outbound calls only

Available options:
user_hangup,
agent_hangup,
call_transfer,
unknown,
busy,
no_answer,
dial_error
call_summary
string | null
employee
string | null

Assigned employee name

note
string | null
agent_id
string<uuid> | null
is_purged
boolean
deleted_at
string<date-time> | null
created_at
string<date-time>
updated_at
string<date-time>
transcript
string | null

JSON string of conversation messages

audio_file_url
string<uri> | null

Recording URL as stored by the voice agent. Not re-signed by the API — it may have expired; use the Dashboard for playback

final_score
number | null

AI-generated quality score (1-10)

Required range: 1 <= x <= 10