List Call Histories

Retrieve a list of call history records in your workspace.

GET /v2/api/call-history

List Call Histories

cURL

curl --request GET \
  --url https://api.trillet.ai/v2/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": []
  }
]