Call Summary(Agent Wise)

Get agent executions list (per-call records)

curl --request GET \
  --url https://www.tryunleashx.com/api/v1/global/agents/executions/list \
  --header 'token: <token>'

const options = {method: 'GET', headers: {token: '<token>'}};

fetch('https://www.tryunleashx.com/api/v1/global/agents/executions/list', 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://www.tryunleashx.com/api/v1/global/agents/executions/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "token: <token>"
  ],
]);

$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://www.tryunleashx.com/api/v1/global/agents/executions/list"

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

	req.Header.Add("token", "<token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.tryunleashx.com/api/v1/global/agents/executions/list")

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

request = Net::HTTP::Get.new(url)
request["token"] = '<token>'

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

{
  "datalist": [
    {
      "ID": 123,
      "AGENT_ID": 123,
      "agent_name": "<string>",
      "CALLING_NUMBER": "<string>",
      "PROVIDER_NUMBER": "<string>",
      "STATUS": "<string>",
      "CALL_STATUS": "<string>",
      "TOTAL_DURATION": 123,
      "total_duration": "<string>",
      "CREATED_AT": "<string>",
      "TRANSCRIPT": "<string>",
      "FILE_PATH": "<string>",
      "DISPOSITION": "<string>"
    }
  ]
}

GET

agents

executions

list

Get agent executions list (per-call records)

curl --request GET \
  --url https://www.tryunleashx.com/api/v1/global/agents/executions/list \
  --header 'token: <token>'

const options = {method: 'GET', headers: {token: '<token>'}};

fetch('https://www.tryunleashx.com/api/v1/global/agents/executions/list', 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://www.tryunleashx.com/api/v1/global/agents/executions/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "token: <token>"
  ],
]);

$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://www.tryunleashx.com/api/v1/global/agents/executions/list"

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

	req.Header.Add("token", "<token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.tryunleashx.com/api/v1/global/agents/executions/list")

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

request = Net::HTTP::Get.new(url)
request["token"] = '<token>'

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

{
  "datalist": [
    {
      "ID": 123,
      "AGENT_ID": 123,
      "agent_name": "<string>",
      "CALLING_NUMBER": "<string>",
      "PROVIDER_NUMBER": "<string>",
      "STATUS": "<string>",
      "CALL_STATUS": "<string>",
      "TOTAL_DURATION": 123,
      "total_duration": "<string>",
      "CREATED_AT": "<string>",
      "TRANSCRIPT": "<string>",
      "FILE_PATH": "<string>",
      "DISPOSITION": "<string>"
    }
  ]
}

Retrieve per-call records (executions) for agents. This endpoint returns detailed call-level records (transcripts, audio paths, durations, dispositions, etc.) and supports multiple filters.

API Endpoint

GET /api/v1/global/agents/executions/list Content-Type: application/json Authentication: Required (API token validated by middleware apiauth.verifyToken). Provide token via header token or api_access_token.

Query Parameters

Parameter	Type	Required	Description
`agent_id`	integer	No	Filter records for a specific agent.
`calling_number`	string	No	Partial-match against `CALLING_NUMBER` (uses SQL LIKE).
`provider_number`	string	No	Exact match against `PROVIDER_NUMBER`.
`status`	string/integer	No	Filter by execution `STATUS` (or `CALL_STATUS` in some places). Examples: `completed`, `failed`.
`fromdate`	string	No	Start date (e.g. `2025-01-01` or datetime). Defaults to 1 month back if omitted.
`todate`	string	No	End date. Defaults to now if omitted.
`page`	integer	No	Page number (used with `limit` to paginate results).
`limit`	integer	No	Page size / limit.
`audio_url`	string	No	Use `available` to return records that have an audio file (`FILE_PATH` present).
`transcript`	string	No	Use `available` to return records that have `TRANSCRIPT` present.
`sentiment`	string	No	Filter by `OVERALL_SENTIMENT` (if voice analysis available).
`disposition`	string	No	Comma-separated dispositions; will be applied as SQL IN filter.
`emotion`	string	No	Filter by `DETECTED_EMOTION`.
`input_data`	string	No	Partial-match (`LIKE`) against `INPUT_DATA`.
`cost_breakdown`	string	No	Partial-match (`LIKE`) against `COST_BREAKDOWN` or within `RETURN_DATA`.
`duration`	string	No	Range filter (e.g., `30-300`) for `TOTAL_DURATION` (per-call list).

Note: The handler accepts parameters from req.query (GET). The underlying implementation also supports similar filters for POST bodies in the agent controller, but this global route is exposed as GET.

Example Requests

Get executions for an agent (GET)

curl -X GET "https://www.tryunleashx.com/api/v1/global/agents/executions/list?agent_id=962&page=1&limit=50&fromdate=2025-01-01&todate=2025-01-31" \
  -H "token: YOUR_API_TOKEN"

Filter by calling number (partial)

curl -X GET "https://www.tryunleashx.com/api/v1/global/agents/executions/list?agent_id=962&calling_number=91234&page=1&limit=20" \
  -H "token: YOUR_API_TOKEN"

Filter by audio availability and transcript

curl -X GET "https://www.tryunleashx.com/api/v1/global/agents/executions/list?agent_id=962&audio_url=available&transcript=available" \
  -H "token: YOUR_API_TOKEN"

Filter by disposition and sentiment

curl -X GET "https://www.tryunleashx.com/api/v1/global/agents/executions/list?agent_id=962&disposition=resolved,followup&sentiment=positive" \
  -H "token: YOUR_API_TOKEN"

Successful Response (200)

Returns an object with datalist containing call execution records. Each record includes many fields; the key fields are listed below. The controller formats durations and dates (e.g., total_duration as 1h:2m:3s, date, time).

{
  "datalist": [
    {
      "ID": 98765,
      "AGENT_ID": 962,
      "agent_name": "Support Agent A",
      "CALLING_NUMBER": "+919876543210",
      "PROVIDER_NUMBER": "+14045551234",
      "STATUS": "completed",
      "CALL_STATUS": "completed",
      "TOTAL_DURATION": 185,                // raw seconds in DB (in code returned as TOTAL_DURATION but formatted)
      "total_duration": "3m:5s",            // formatted string added by controller
      "CREATED_AT": "2025-01-15T10:12:34Z",
      "date": "15 Jan, 2025",
      "time": "10:12",
      "TRANSCRIPT": "Customer said ...",
      "FILE_PATH": "https://storage.example.com/recordings/..",
      "DISPOSITION": "resolved",
      "SUMMARY": "Call summary text",
      "RETURN_DATA": { /* trimmed, filtered in response */ },
      "INPUT_DATA": { /* request metadata */ },
      "COST_BREAKDOWN": [ /* formatted cost items */ ],
      "VOICE_CALL_ANALYSIS": { /* optional analysis */ },
      "VOICE_QUALITY_FEEDBACK": 1,
      "workflow_name": "Support Flow",
      "workflow_type": "IVR"
    }
  ]
}

Field Notes

total_duration is formatted by the controller as Xh:Ym:Zs or Mm:Ss style for readability (the DB stores seconds).
RETURN_DATA is filtered to remove some internal fields; cost_breakdown may be moved into RETURN_DATA.cost_breakdown if present.
FILE_PATH is the URL to audio recording (if available).
TRANSCRIPT may be null or empty if speech-to-text was not produced.
VOICE_QUALITY_FEEDBACK is a numeric rating stored for voice analysis (e.g., upvote/downvote).
agent_name is provided via join with agent details when available.

Pagination

The endpoint accepts page and limit to paginate results. The controller applies limit and offset when querying.
Note: the current implementation returns only datalist (array) and does not include pagination metadata (totalRecords, totalPages) in the response. Use page and limit to page through results.

Error Responses

400 Bad Request

{
  "error": true,
  "code": 400,
  "message": "Invalid parameters",
  "data": {}
}

401 Unauthorized

{
  "error": true,
  "code": 401,
  "message": "Invalid Auth Key or Session Expired",
  "data": {}
}

500 Internal Server Error

{
  "error": true,
  "code": 500,
  "message": "Internal server error",
  "data": {}
}

Important Notes & Recommendations

Use narrow date ranges (≤ 3 months) for faster queries. The underlying controller defaults to 1 month if fromdate/todate are omitted.
For more aggregate/grouped metrics use /api/v1/global/agents/call-history (agent-level summary).
For export of conversational data (Excel), the system provides a separate endpoint (downloadConversationalData) which streams an XLSX.
If you need pagination metadata added to the response, we can update the controller to include totalRecords and totalPages.

Headers

token

string

required

API token for authentication

Query Parameters

agent_id

integer

calling_number

string

provider_number

string

status

string

fromdate

string

todate

string

page

integer

limit

integer

audio_url

string

transcript

string

Response

Executions list retrieved

datalist

object[]

Show child attributes

API Documentation

Phone Numbers

Voice AI

Click to Call

Call Logs

Campaigns

Users

Call Summary(Agent Wise)

API Endpoint

Query Parameters

Example Requests

Get executions for an agent (GET)

Filter by calling number (partial)

Filter by audio availability and transcript

Filter by disposition and sentiment

Successful Response (200)

Field Notes

Error Responses

400 Bad Request

401 Unauthorized

500 Internal Server Error

Important Notes & Recommendations

Headers

Query Parameters

Response

​API Endpoint

​Query Parameters

​Example Requests

​Get executions for an agent (GET)

​Filter by calling number (partial)

​Filter by audio availability and transcript

​Filter by disposition and sentiment

​Successful Response (200)

​Field Notes

​Pagination

​Error Responses

​400 Bad Request

​401 Unauthorized

​500 Internal Server Error

​Important Notes & Recommendations

Headers

Query Parameters

Response

API Endpoint

Query Parameters

Example Requests

Get executions for an agent (GET)

Filter by calling number (partial)

Filter by audio availability and transcript

Filter by disposition and sentiment

Successful Response (200)

Field Notes

Pagination

Error Responses

400 Bad Request

401 Unauthorized

500 Internal Server Error

Important Notes & Recommendations