Trillet AI logo

Get a Specific Call History

Retrieve detailed information about a specific call history entry.

GEThttps://api.trillet.ai/v2/api/call-history/{callHistoryId}

Headers

x-workspace-idstringrequired

Workspace identifier for the API.

Path Parameters

callHistoryIdstringrequired

The 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.

_idstring

The call history record ID.

timestampnumber

Call start time as Unix seconds.

callIdstring

Call identifier.

roomNamestring

Room name of the call. Web calls start with web-.

directionstring

inbound, outbound or web.

fromPhoneNumberstring

Caller number, or "N/A".

toPhoneNumberstring

Destination number, or "N/A".

statusstring

completed, pending, failed or blocked.

durationnumber

Call length in whole seconds. Omitted when zero or unknown.

agentstring

Agent name, or "N/A".

callFlowNamestring

Call flow name, or "N/A".

costnumber

Amount charged for the call. 0 when not charged.

recordingUrlstring

Authenticated recording URL, or null.

summarystring

Call summary, or null.

analyzedDataobject

Post-call analysis results. Keys depend on the call flow's post-call analysis settings.

transcriptarray

Transcript entries.

functionCallsarray

Tool calls made during the call.

callEndedBystring

Who ended the call, or "Unknown". Phone calls only.

callEndReasonstring

Why the call ended, or "Unknown". Phone calls only.

twilioCallSidstring

Twilio call SID for calls on Twilio numbers, or null.

headerVariablesarray

Values 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

StatusBodyWhen
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