List assistant conversations (reporting format)
curl --request GET \
--url https://platform.crescendo.ai/api/v1/reporting/tenants/{tenantId}/assistant/conversations \
--header 'Authorization: Bearer <token>'import requests
url = "https://platform.crescendo.ai/api/v1/reporting/tenants/{tenantId}/assistant/conversations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://platform.crescendo.ai/api/v1/reporting/tenants/{tenantId}/assistant/conversations', 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://platform.crescendo.ai/api/v1/reporting/tenants/{tenantId}/assistant/conversations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <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://platform.crescendo.ai/api/v1/reporting/tenants/{tenantId}/assistant/conversations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://platform.crescendo.ai/api/v1/reporting/tenants/{tenantId}/assistant/conversations")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://platform.crescendo.ai/api/v1/reporting/tenants/{tenantId}/assistant/conversations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"total": 123,
"cursor": {
"next": "<string>"
},
"data": [
{
"ID": "<string>",
"TenantID": "<string>",
"BotID": "<string>",
"BotName": "<string>",
"BotVersion": "<string>",
"Datetime": 123,
"EndDatetime": 123,
"DatetimeUTC": "2023-11-07T05:31:56Z",
"EndDatetimeUTC": "2023-11-07T05:31:56Z",
"Duration": 123,
"Escalated": true,
"escalatedAt": 123,
"CSat": 123,
"AgentName": "<string>",
"AgentId": "<string>",
"AgentEmail": "<string>",
"Category": "<string>",
"Subcategory": "<string>",
"Tertiary": "<string>",
"RemoteIp": "<string>",
"userAgent": "<string>",
"Referrer": "<string>",
"Media": "<string>",
"Summary": "<string>",
"Handoff Reason": "<string>",
"ticketId": "<string>",
"ticketUrl": "<string>",
"ticketKind": "<string>",
"Input": "<string>",
"Contact Name": "<string>",
"Contact Email": "<string>",
"Contact Phone": "<string>"
}
]
}{
"code": "BadRequest",
"message": "Invalid request parameters"
}{
"code": "Unauthenticated",
"message": "Authorization header with Bearer token is required"
}{
"code": "PermissionDenied",
"message": "API key does not allow this operation"
}{
"code": "Unavailable",
"message": "Elastic search failed"
}Reporting
Export Assistant conversations (reporting)
Retrieve Assistant conversations in a reporting-friendly format with cursor pagination.
GET
/
api
/
v1
/
reporting
/
tenants
/
{tenantId}
/
assistant
/
conversations
List assistant conversations (reporting format)
curl --request GET \
--url https://platform.crescendo.ai/api/v1/reporting/tenants/{tenantId}/assistant/conversations \
--header 'Authorization: Bearer <token>'import requests
url = "https://platform.crescendo.ai/api/v1/reporting/tenants/{tenantId}/assistant/conversations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://platform.crescendo.ai/api/v1/reporting/tenants/{tenantId}/assistant/conversations', 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://platform.crescendo.ai/api/v1/reporting/tenants/{tenantId}/assistant/conversations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <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://platform.crescendo.ai/api/v1/reporting/tenants/{tenantId}/assistant/conversations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://platform.crescendo.ai/api/v1/reporting/tenants/{tenantId}/assistant/conversations")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://platform.crescendo.ai/api/v1/reporting/tenants/{tenantId}/assistant/conversations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"total": 123,
"cursor": {
"next": "<string>"
},
"data": [
{
"ID": "<string>",
"TenantID": "<string>",
"BotID": "<string>",
"BotName": "<string>",
"BotVersion": "<string>",
"Datetime": 123,
"EndDatetime": 123,
"DatetimeUTC": "2023-11-07T05:31:56Z",
"EndDatetimeUTC": "2023-11-07T05:31:56Z",
"Duration": 123,
"Escalated": true,
"escalatedAt": 123,
"CSat": 123,
"AgentName": "<string>",
"AgentId": "<string>",
"AgentEmail": "<string>",
"Category": "<string>",
"Subcategory": "<string>",
"Tertiary": "<string>",
"RemoteIp": "<string>",
"userAgent": "<string>",
"Referrer": "<string>",
"Media": "<string>",
"Summary": "<string>",
"Handoff Reason": "<string>",
"ticketId": "<string>",
"ticketUrl": "<string>",
"ticketKind": "<string>",
"Input": "<string>",
"Contact Name": "<string>",
"Contact Email": "<string>",
"Contact Phone": "<string>"
}
]
}{
"code": "BadRequest",
"message": "Invalid request parameters"
}{
"code": "Unauthenticated",
"message": "Authorization header with Bearer token is required"
}{
"code": "PermissionDenied",
"message": "API key does not allow this operation"
}{
"code": "Unavailable",
"message": "Elastic search failed"
}This endpoint returns Assistant conversations as reporting rows (no message content), suitable for exporting large time ranges.
If you already know the conversation ID, read that conversation directly without list pagination or a date range.
Date range filtering
You can specify a time range using either:range=last_day|last_week|last_month, orfrom/to(ISO 8601 or epoch millis)
range=last_day.
Pagination (cursor)
Results are paginated using an opaque cursor:- Use
limitto control page size (default1000, max5000) - Use
cursorto fetch the next page (fromcursor.next) - When you supply
cursor, do not also supplyrange,from, orto
Example: first page
export CRESCENDO_TENANT_ID="tenant-alpha"
export CRESCENDO_API_KEY="YOUR_API_KEY"
curl -sS \
-H "Authorization: Bearer $CRESCENDO_API_KEY" \
"https://platform.crescendo.ai/api/v1/reporting/tenants/$CRESCENDO_TENANT_ID/assistant/conversations?range=last_week&limit=1000"
Example: next page
export CURSOR="PASTE_cursor.next_HERE"
curl -sS -G \
-H "Authorization: Bearer $CRESCENDO_API_KEY" \
--data-urlencode "cursor=$CURSOR" \
"https://platform.crescendo.ai/api/v1/reporting/tenants/$CRESCENDO_TENANT_ID/assistant/conversations"
Example: fetch all pages (Node.js)
const baseUrl = 'https://platform.crescendo.ai';
async function fetchAllAssistantConv({ tenantId, apiKey, limit = 1000, range = 'last_week' }) {
const allRows = [];
// First request can use range/from/to
let cursor = null;
let first = true;
while (true) {
const url = new URL(`${baseUrl}/api/v1/reporting/tenants/${tenantId}/assistant/conversations`);
if (first) {
url.searchParams.set('range', range);
url.searchParams.set('limit', String(limit));
first = false;
} else {
url.searchParams.set('cursor', cursor);
url.searchParams.set('limit', String(limit));
}
const res = await fetch(url, {
headers: { Authorization: `Bearer ${apiKey}` },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const body = await res.json();
allRows.push(...(body.data ?? []));
cursor = body?.cursor?.next;
if (!cursor) break;
}
return allRows;
}
Authorizations
bearerAuthbearerTokenQuery

