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>'

import requests

url = "https://api.trillet.ai/v2/api/call-history/{callHistoryId}"

headers = {
    "x-api-key": "<api-key>",
    "x-workspace-id": "<x-workspace-id>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-api-key': '<api-key>', 'x-workspace-id': '<x-workspace-id>'}
};

fetch('https://api.trillet.ai/v2/api/call-history/{callHistoryId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.trillet.ai/v2/api/call-history/{callHistoryId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>",
    "x-workspace-id: <x-workspace-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.trillet.ai/v2/api/call-history/{callHistoryId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("x-workspace-id", "<x-workspace-id>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.trillet.ai/v2/api/call-history/{callHistoryId}")
  .header("x-api-key", "<api-key>")
  .header("x-workspace-id", "<x-workspace-id>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.trillet.ai/v2/api/call-history/{callHistoryId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
request["x-workspace-id"] = '<x-workspace-id>'

response = http.request(request)
puts response.read_body

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

GET

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>'

import requests

url = "https://api.trillet.ai/v2/api/call-history/{callHistoryId}"

headers = {
    "x-api-key": "<api-key>",
    "x-workspace-id": "<x-workspace-id>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-api-key': '<api-key>', 'x-workspace-id': '<x-workspace-id>'}
};

fetch('https://api.trillet.ai/v2/api/call-history/{callHistoryId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.trillet.ai/v2/api/call-history/{callHistoryId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>",
    "x-workspace-id: <x-workspace-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.trillet.ai/v2/api/call-history/{callHistoryId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("x-workspace-id", "<x-workspace-id>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.trillet.ai/v2/api/call-history/{callHistoryId}")
  .header("x-api-key", "<api-key>")
  .header("x-workspace-id", "<x-workspace-id>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.trillet.ai/v2/api/call-history/{callHistoryId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
request["x-workspace-id"] = '<x-workspace-id>'

response = http.request(request)
puts response.read_body

{
  "_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

string

required

API key used for authenticating requests to the API.

string

required

Workspace identifier for the API.

Path Parameters

string

required

The unique identifier of the call record in the database.

Response Fields

string

The unique identifier for the call history record.

string

The identifier of the workspace associated with this call history.

string

The identifier of the agent involved in the call.

string

The identifier of the call flow used during the call.

string

The virtual room name where the call took place.

string

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

string

The phone number from which the call originated.

string

The phone number to which the call was made.

string

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

number

The start time of the call as a Unix timestamp.

number

The end time of the call as a Unix timestamp.

object

Details of the costs incurred during the call.

number

The charge to the customer for the call.

object

Additional metadata associated with the call.

array

An array detailing any functional calls made during the interaction.

string

A brief summary of the call.

object

Analyzed data from the call that may include additional fields.

string

Additional details from the analyzed data.

string

Timestamp when the call history was created.

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

API Reference V1

Workspaces

Calls

Batch Calls

Telephony

Conversations

Folder Management

Call Flows

Message Flows

Call Agents

Omni Flow Agents (Message)

Knowledge Base

Active Calls

Recordings

Get a Specific Call History

Headers

Path Parameters

Response Fields

​Headers

​Path Parameters

​Response Fields

Headers

Path Parameters

Response Fields