GET
/
v1
/
api
/
call-history
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": []
  }
]