Get a Specific Call History

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

Headers

x-api-keystringrequired

API key used for authenticating requests to the API.

x-workspace-idstringrequired

Workspace identifier for the API.

Path Parameters

callHistoryIdstringrequired

The unique identifier of the call record in the database.

Response Fields

_idstring

The unique identifier for the call history record.

workspaceIdstring

The identifier of the workspace associated with this call history.

agentIdstring

The identifier of the agent involved in the call.

callFlowIdstring

The identifier of the call flow used during the call.

roomNamestring

The virtual room name where the call took place.

directionstring

The direction of the call (e.g., "inbound" or "outbound").

fromPhoneNumberstring

The phone number from which the call originated.

toPhoneNumberstring

The phone number to which the call was made.

statusstring

The final status of the call (e.g., "completed", "failed", "ongoing").

startTimenumber

The start time of the call as a Unix timestamp.

endTimenumber

The end time of the call as a Unix timestamp.

costobject

Details of the costs incurred during the call.

customer_chargenumber

The charge to the customer for the call.

metadataobject

Additional metadata associated with the call.

functionCallsarray

An array detailing any functional calls made during the interaction.

summarystring

A brief summary of the call.

analyzedDataobject

Analyzed data from the call that may include additional fields.

additional_fieldstring

Additional details from the analyzed data.

createdAtstring

Timestamp when the call history was created.

updatedAtstring

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"
}