Get a Specific Call History
Retrieve detailed information about a specific call history entry.
Headers
x-workspace-idstringrequiredWorkspace identifier for the API.
Path Parameters
callHistoryIdstringrequiredThe call history record ID (the _id from List Call Histories).
Response Fields
The record has the same shape as one item of data in List Call Histories, with these differences: the transcript is always included, and pathwayName, telephonyCost, warmTransferCharge, warmTransferMinutes and mode are not returned.
_idstringThe call history record ID.
timestampnumberCall start time as Unix seconds.
callIdstringCall identifier.
roomNamestringRoom name of the call. Web calls start with web-.
directionstringinbound, outbound or web.
fromPhoneNumberstringCaller number, or "N/A".
toPhoneNumberstringDestination number, or "N/A".
statusstringcompleted, pending, failed or blocked.
durationnumberCall length in whole seconds. Omitted when zero or unknown.
agentstringAgent name, or "N/A".
callFlowNamestringCall flow name, or "N/A".
costnumberAmount charged for the call. 0 when not charged.
recordingUrlstringAuthenticated recording URL, or null.
summarystringCall summary, or null.
analyzedDataobjectPost-call analysis results. Keys depend on the call flow's post-call analysis settings.
transcriptarrayTranscript entries.
functionCallsarrayTool calls made during the call.
callEndedBystringWho ended the call, or "Unknown". Phone calls only.
callEndReasonstringWhy the call ended, or "Unknown". Phone calls only.
twilioCallSidstringTwilio call SID for calls on Twilio numbers, or null.
headerVariablesarrayValues of mapped SIP headers for inbound calls on Bring Your Own Twilio numbers, as { key, value } objects. [] when none.
See List Call Histories for the remaining fields (charged_duration, error, hasTelephonyCost, publicRecordingUrl, batchId, pendingReason, variables, dynamic_variables, llm/stt/tts, bookingOutcome and others).
Errors
| Status | Body | When |
|---|---|---|
400 | {"error": "Workspace ID is required", "code": "WORKSPACE_ID_REQUIRED"} | The x-workspace-id header is missing |
400 | {"error": "Invalid call history ID", "code": "CALL_HISTORY_ID_INVALID"} | callHistoryId is not a 24-character hex ID |
404 | {"error": "Call history record not found", "code": "CALL_HISTORY_NOT_FOUND"} | No call with that ID exists in this workspace |
500 | {"error": "Could not fetch call history", "code": "CALL_HISTORY_FETCH_FAILED"} | Unexpected server error. Safe to retry |
{
"_id": "d8d8d8d8d8d8d8d8d8d8d8d8",
"timestamp": 1761731294,
"callId": "d3d3d3d3d3d3d3d3d3d3d3d3-k3j9x0a1bq",
"fromPhoneNumber": "+14155550123",
"toPhoneNumber": "+14155550188",
"direction": "outbound",
"duration": 42,
"charged_duration": 42,
"transferTiming": null,
"agentSegments": null,
"agent": "Front Desk",
"status": "completed",
"error": "None",
"callFlowName": "Appointment Booking",
"cost": 0.12,
"hasTelephonyCost": false,
"isCallFromSmartCallback": false,
"recordingUrl": "https://api.trillet.ai/v2/api/recordings/d8d8d8d8d8d8d8d8d8d8d8d8",
"publicRecordingUrl": null,
"timezone": "America/Los_Angeles",
"scheduledTime": null,
"currentTimeOfGivenTimezone": null,
"pendingReason": null,
"nextAttemptAt": null,
"publicRecording": null,
"batchId": null,
"roomName": "d3d3d3d3d3d3d3d3d3d3d3d3-k3j9x0a1bq",
"summary": "Caller booked a consultation for Tuesday.",
"analyzedData": {
"call_disposition": "booked",
"call_sentiment": "positive"
},
"variables": {},
"transcript": [],
"hipaaCompliance": false,
"functionCalls": [],
"dynamic_variables": {},
"twilioCallSid": "CA0123456789abcdef0123456789abcdef",
"headerVariables": [{ "key": "store_id", "value": "1042" }],
"llm": { "model": "gpt-4.1" },
"stt": {},
"tts": {},
"postCallStatus": null,
"preCallWebhook": null,
"postCallEmailDeliveries": [],
"bookingOutcome": null,
"callEndedBy": "Unknown",
"callEndReason": "Unknown"
}Last updated on