GET
/
v2
/
api
/
call-history
/
{callHistoryId}
Get a Specific Call History
curl --request GET \
  --url https://api.trillet.ai/v2/api/call-history/{callHistoryId} \
  --header 'x-api-key: <api-key>' \
  --header 'x-workspace-id: <x-workspace-id>'
{
  "_id": "1234567890abcdef",
  "workspaceId": "abcdef1234567890",
  "agentId": "abcdef1234567890",
  "callFlowId": "abcdef1234567890",
  "roomName": "web-1234abcd",
  "direction": "outbound",
  "fromPhoneNumber": "+10000000000",
  "toPhoneNumber": "+10000000001",
  "status": "completed",
  "startTime": 1680000000,
  "endTime": 1680000300,
  "cost": {
    "customer_charge": 0.10
  },
  "metadata": {},
  "functionCalls": [],
  "summary": "Generic conversation summary about customer engagement.",
  "analyzedData": {
    "additional_field": "generic details"
  },
  "createdAt": "2025-01-01T10:00:00Z",
  "updatedAt": "2025-01-01T10:05:00Z"
}

​
Headers

​
x-api-key
string
required
API key used for authenticating requests to the API.
​
x-workspace-id
string
required
Workspace identifier for the API.

​
Path Parameters

​
callHistoryId
string
required
The unique identifier of the call record in the database.

​
Response Fields

​
_id
string
The unique identifier for the call history record.
​
workspaceId
string
The identifier of the workspace associated with this call history.
​
agentId
string
The identifier of the agent involved in the call.
​
callFlowId
string
The identifier of the call flow used during the call.
​
roomName
string
The virtual room name where the call took place.
​
direction
string
The direction of the call (e.g., “inbound” or “outbound”).
​
fromPhoneNumber
string
The phone number from which the call originated.
​
toPhoneNumber
string
The phone number to which the call was made.
​
status
string
The final status of the call (e.g., “completed”, “failed”, “ongoing”).
​
startTime
number
The start time of the call as a Unix timestamp.
​
endTime
number
The end time of the call as a Unix timestamp.
​
cost
object
Details of the costs incurred during the call.
​
customer_charge
number
The charge to the customer for the call.
​
metadata
object
Additional metadata associated with the call.
​
functionCalls
array
An array detailing any functional calls made during the interaction.
​
summary
string
A brief summary of the call.
​
analyzedData
object
Analyzed data from the call that may include additional fields.
​
additional_field
string
Additional details from the analyzed data.
​
createdAt
string
Timestamp when the call history was created.
​
updatedAt
string
Timestamp when the call history was last updated.
{
  "_id": "1234567890abcdef",
  "workspaceId": "abcdef1234567890",
  "agentId": "abcdef1234567890",
  "callFlowId": "abcdef1234567890",
  "roomName": "web-1234abcd",
  "direction": "outbound",
  "fromPhoneNumber": "+10000000000",
  "toPhoneNumber": "+10000000001",
  "status": "completed",
  "startTime": 1680000000,
  "endTime": 1680000300,
  "cost": {
    "customer_charge": 0.10
  },
  "metadata": {},
  "functionCalls": [],
  "summary": "Generic conversation summary about customer engagement.",
  "analyzedData": {
    "additional_field": "generic details"
  },
  "createdAt": "2025-01-01T10:00:00Z",
  "updatedAt": "2025-01-01T10:05:00Z"
}