Skip to main content
GET
Get call details

Authorizations

Authorization
string
header
required

Use Authorization: Bearer tc_live_xxxxx

Path Parameters

call_id
string<uuid>
required

Call UUID

Response

The call.

id
string<uuid>
account_id
string<uuid>
phone_number
string | null

The other party, in E.164.

Example:

"+14155551234"

from_phone_number
string | null

Your side of the call (the caller ID on outbound), in E.164.

Example:

"+18005551234"

direction
enum<string>

outbound means the platform placed the call; inbound means it came in on one of your numbers.

Available options:
outbound,
inbound
Example:

"outbound"

transferred_to
string | null

Present only when the agent tried to connect the caller to a person. The destination's label once connected, otherwise null.

transfer_status
string

Present with transferred_to. completed, failed, abandoned_by_caller or not_allowed.

status
enum<string>

queued while waiting, scheduled or ringing, in_progress once answered, then completed, failed or cancelled.

Available options:
pending,
queued,
in_progress,
completed,
failed,
cancelled
call_status
string | null

Telephony state, for example ringing, in-progress, completed, no-answer, busy, failed or cancelled. retrying means it's redialing from another of your numbers; dispatch_timeout means it wasn't dialed before its dispatch window closed.

external_call_id
string | null

Telephony call ID.

duration
number | null

Talk time in minutes.

Example:

2.5

transcript
object[] | null

Spoken turns plus tool uses, crew handoffs, signals, interruptions and how the call ended.

Example:
recording_url
string<uri> | null

Appears 15 seconds to about 2.5 minutes after the call ends. Stays null if no recording turns up in that time.

Example:

"https://api.example.com/recordings/2025/12/22/mp3"

call_summary
string | null

Written after the call; shape it with summary_prompt.

error_message
string | null

Why the call failed.

answered_by
enum<string> | null
Available options:
human,
voicemail,
ivr,
unknown
campaign_id
string<uuid> | null

The campaign the call ran for or borrowed a knowledge base from.

lead_id
string<uuid> | null

The lead the call was for.

completed
boolean | null

True once the call is finalized.

created_at
string<date-time>
started_at
string<date-time> | null
end_at
string<date-time> | null
metadata
object

Your metadata keys, plus lead_context, max_duration and attempt_number when the call had them. Internal settings are never included.

disposition
string | null

The call_outcome value from your analysis_schema, or a platform label: Voicemail, Transferred or No Response.

actual_duration_billed
number | null

Minutes billed.

Example:

2.5

analysis
object | null

The fields extracted by analysis_schema. Null when none were produced.