Skip to navigation
API ReferenceCalls

Get full call details

Returns comprehensive call information including:

  • Basic call data
  • Contact info (name, phone, email, company)
  • Flow info (name, version)
  • Transcript (structured messages with timestamps)
  • AI Analysis (summary, sentiment, intents, topics, action items, outcome)
  • Cost breakdown (LLM, TTS, STT, Telephony with details)
  • Quality metrics (MOS, jitter, latency, packet loss)
  • Timeline events

Authentication

AuthorizationBearer

Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.

Path parameters

callIdstringRequiredformat: "uuid"
Call ID

Response

Full call details
accountIdstringformat: "uuid"
Account that owns this call
callSidstring
Twilio Call SID
createdAtdatetime
When the call record was created
directionenum

Call direction (inbound or outbound)

Allowed values:
fromNumberstring
Caller phone number in E.164 format
idstringformat: "uuid"
Unique call identifier
isAnalyzedboolean

Whether AI-powered post-call analysis has been performed

isRecordedboolean
Whether audio recording was enabled for this call
providerTypeenum
Telephony provider type used for this call
Allowed values:
sourceenum
Where the call originated from
Allowed values:
statusenum

User-facing computed call status

timelinelist of objects
Chronological timeline of events during the call
toNumberstring
Destination phone number in E.164 format
campaignIdstring or nullOptionalformat: "uuid"
Campaign ID if the call is part of a bulk campaign
contactobject or nullOptional
Contact summary for the call details page
coststring or nullOptional

Total cost in USD (string for decimal precision)

costBreakdownobject or nullOptional
Detailed cost breakdown by service
durationinteger or nullOptional
Call duration in seconds
endReasonenum or nullOptional

Why a call ended — set once when a call reaches terminal state.

Unlike failure_code which categorizes technical failures, end_reason captures the causal signal that ended the call regardless of success/failure. First writer wins (COALESCE pattern in SQL).

endedAtdatetime or nullOptional
When the call ended
failureCodeenum or nullOptional

Tracks the specific reason a call failed, enabling:

  • Analytics (which failure types are most common)
  • Callbacks (schedule callback for capacity-rejected inbound calls)
  • Debugging (detailed failure tracking)
failureReasonstring or nullOptional

Human-readable failure description

flowobject or nullOptional
Flow summary for the call details page
flowIdstring or nullOptionalformat: "uuid"
Flow ID used for the AI conversation
insightsobject or nullOptional

AI-powered post-call analysis including summary, sentiment, intents, and action items

performanceobject or nullOptional

Call performance metrics — latency, conversation, and usage analytics

qualityobject or nullOptional
Call quality metrics derived from Twilio Voice Insights
recordingDurationSecsdouble or nullOptional
Recording duration in seconds
recordingExpiresAtdatetime or nullOptional
When the recording will be automatically deleted from storage
recordingFileSizeByteslong or nullOptional
Recording file size in bytes
recordingStatusstring or nullOptional

Recording lifecycle status: “started”, “ready”, or “failed”

recordingStorageCoststring or nullOptional
Upfront recording storage cost in USD
scheduleIdstring or nullOptionalformat: "uuid"
Schedule ID if the call was triggered by a recurring schedule
startedAtdatetime or nullOptional
When the call was answered
transcriptlist of objects or nullOptional

Structured transcript of the conversation (ordered by timestamp)

transferCaseobject or nullOptional

Handoff case the AI passed when it transferred the call to a person: reason, summary, optional caller_name, plus any custom fields configured on the Transfer node. Present only for transferred calls.

turnslist of objects or nullOptional

Turn-by-turn conversation data with per-turn metrics and function calls

voicemailDetectedAtdatetime or nullOptional

When voicemail detection produced a result (null if none)

voicemailStatusstring or nullOptional

Voicemail detection outcome (null if detection was off or no result): “voicemail_detected”, “human_detected”, or “undetermined”

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error