GET
/
v1
/
api
/
call-history
List Call Histories
curl --request GET \
  --url https://api.trillet.ai/v1/api/call-history \
  --header 'x-api-key: <api-key>' \
  --header 'x-workspace-id: <x-workspace-id>'
[
  {
    "_id": "00000000bf7ca4a7c69e0000",
    "timestamp": 1737062894.9754236,
    "callId": "00000000013bd867b55ca000-00t00imaqj",
    "fromPhoneNumber": "+00000000000",
    "toPhoneNumber": "+00000000000",
    "direction": "bidirectional",
    "agent": "SampleAgent",
    "status": "active",
    "callFlowName": "Example Call Flow",
    "cost": 0,
    "recordingUrl": null,
    "summary": "Call summary here",
    "analyzedData": {},
    "variables": {},
    "transcript": []
  },
  {
    "_id": "00000000cbddbe9988450000",
    "timestamp": 1737061847.891025,
    "callId": "00000000013bd867b55ca000-00pk0su000",
    "fromPhoneNumber": "+00000000000",
    "toPhoneNumber": "+00000000000",
    "direction": "bidirectional",
    "duration": 0,
    "agent": "SampleAgent",
    "status": "completed",
    "callFlowName": "Example Call Flow",
    "cost": 0,
    "recordingUrl": null,
    "summary": "Call summary here",
    "analyzedData": {
      "answered_by_voicemail": false
    },
    "variables": {},
    "transcript": []
  }
]

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

​
Response Fields

​
_id
string
The unique identifier for the call history record.
​
timestamp
number
The Unix timestamp indicating when the call was made.
​
callId
string
A unique identifier associated with the specific call.
​
fromPhoneNumber
string
The phone number from which the call originated.
​
toPhoneNumber
string
The phone number to which the call was directed.
​
direction
string
The direction of the call, typically “inbound”, “outbound”, or “bidirectional”.
​
agent
string
The name or identifier of the agent involved in the call.
​
status
string
The status of the call, such as “active”, “completed”, or other relevant statuses.
​
callFlowName
string
The name of the call flow used during the call.
​
cost
number
The cost incurred for the call, if applicable.
​
recordingUrl
string
A URL pointing to the recorded audio of the call, if available.
​
summary
string
A brief summary or overview of the call.
​
analyzedData
object
An object containing additional analyzed data from the call, such as flags for voicemail detection or other specific features.
​
answered_by_voicemail
boolean
Indicates whether the call was answered by a voicemail system.
​
variables
object
Any variables that were used or modified during the call.
​
transcript
array
An array containing elements of the call transcript, if available.
[
  {
    "_id": "00000000bf7ca4a7c69e0000",
    "timestamp": 1737062894.9754236,
    "callId": "00000000013bd867b55ca000-00t00imaqj",
    "fromPhoneNumber": "+00000000000",
    "toPhoneNumber": "+00000000000",
    "direction": "bidirectional",
    "agent": "SampleAgent",
    "status": "active",
    "callFlowName": "Example Call Flow",
    "cost": 0,
    "recordingUrl": null,
    "summary": "Call summary here",
    "analyzedData": {},
    "variables": {},
    "transcript": []
  },
  {
    "_id": "00000000cbddbe9988450000",
    "timestamp": 1737061847.891025,
    "callId": "00000000013bd867b55ca000-00pk0su000",
    "fromPhoneNumber": "+00000000000",
    "toPhoneNumber": "+00000000000",
    "direction": "bidirectional",
    "duration": 0,
    "agent": "SampleAgent",
    "status": "completed",
    "callFlowName": "Example Call Flow",
    "cost": 0,
    "recordingUrl": null,
    "summary": "Call summary here",
    "analyzedData": {
      "answered_by_voicemail": false
    },
    "variables": {},
    "transcript": []
  }
]