curl -G "https://backend.botcadence.com/organizations/ORG_ID/conversation-analytics" \
-H "X-API-Key: bot_live_YOUR_KEY" \
--data-urlencode 'filters={"status":"completed","start_time":{"$gte":"2026-07-01T00:00:00Z","$lte":"2026-07-22T23:59:59Z"}}'
const params = new URLSearchParams({
filters: JSON.stringify({
status: "completed",
start_time: {
$gte: "2026-07-01T00:00:00Z",
$lte: "2026-07-22T23:59:59Z",
},
}),
});
const response = await fetch(
`https://backend.botcadence.com/organizations/${organizationId}/conversation-analytics?${params}`,
{ headers: { "X-API-Key": process.env.BOTCADENCE_API_KEY } }
);
import json
import os
import requests
response = requests.get(
f"https://backend.botcadence.com/organizations/{organization_id}/conversation-analytics",
headers={"X-API-Key": os.environ["BOTCADENCE_API_KEY"]},
params={
"filters": json.dumps(
{
"status": "completed",
"start_time": {
"$gte": "2026-07-01T00:00:00Z",
"$lte": "2026-07-22T23:59:59Z",
},
}
)
},
)
{
"status": "success",
"message": "Conversation analytics retrieved successfully",
"data": {
"summary": {
"total_conversations": 150,
"completed_conversations": 98,
"live_conversations": 2,
"total_duration": 18420.5,
"avg_duration": 122.8
},
"daily_conversations": {
"2026-07-01": 12,
"2026-07-02": 18
},
"daily_durations": {
"2026-07-01": 1402.5,
"2026-07-02": 2105.0
}
},
"status_code": 200
}
Analytics
Get organization conversation analytics
Retrieve voice conversation analytics for an organization
GET
/
organizations
/
{organization_id}
/
conversation-analytics
curl -G "https://backend.botcadence.com/organizations/ORG_ID/conversation-analytics" \
-H "X-API-Key: bot_live_YOUR_KEY" \
--data-urlencode 'filters={"status":"completed","start_time":{"$gte":"2026-07-01T00:00:00Z","$lte":"2026-07-22T23:59:59Z"}}'
const params = new URLSearchParams({
filters: JSON.stringify({
status: "completed",
start_time: {
$gte: "2026-07-01T00:00:00Z",
$lte: "2026-07-22T23:59:59Z",
},
}),
});
const response = await fetch(
`https://backend.botcadence.com/organizations/${organizationId}/conversation-analytics?${params}`,
{ headers: { "X-API-Key": process.env.BOTCADENCE_API_KEY } }
);
import json
import os
import requests
response = requests.get(
f"https://backend.botcadence.com/organizations/{organization_id}/conversation-analytics",
headers={"X-API-Key": os.environ["BOTCADENCE_API_KEY"]},
params={
"filters": json.dumps(
{
"status": "completed",
"start_time": {
"$gte": "2026-07-01T00:00:00Z",
"$lte": "2026-07-22T23:59:59Z",
},
}
)
},
)
{
"status": "success",
"message": "Conversation analytics retrieved successfully",
"data": {
"summary": {
"total_conversations": 150,
"completed_conversations": 98,
"live_conversations": 2,
"total_duration": 18420.5,
"avg_duration": 122.8
},
"daily_conversations": {
"2026-07-01": 12,
"2026-07-02": 18
},
"daily_durations": {
"2026-07-01": 1402.5,
"2026-07-02": 2105.0
}
},
"status_code": 200
}
Returns organization-level voice conversation analytics: totals, average duration, and daily conversation/duration maps.
Authentication
string
required
Project API key for this organization. Format:
bot_live_…Path parameters
string
required
Organization ID. Must match the API key.
Query parameters
string
JSON MongoDB-compatible filter object. Example:
{"status":"completed","start_time":{"$gte":"2026-07-01T00:00:00Z","$lte":"2026-07-22T23:59:59Z"}}.integer
default:"0"
Accepted for compatibility. Aggregation returns summary series (not a paged conversation list).
integer
default:"20"
Accepted for compatibility (
1–1000). Not applied to the summary aggregation.string
Accepted for compatibility. Not applied to the summary aggregation.
Response
object
required
object
required
Map of date bucket key → conversation count.
object
required
Map of date bucket key → total duration seconds.
Errors
Bad Request
Invalid organization id.
Unauthorized
Missing, invalid, or revoked API key.
Forbidden
API key is not authorized for this organization.
curl -G "https://backend.botcadence.com/organizations/ORG_ID/conversation-analytics" \
-H "X-API-Key: bot_live_YOUR_KEY" \
--data-urlencode 'filters={"status":"completed","start_time":{"$gte":"2026-07-01T00:00:00Z","$lte":"2026-07-22T23:59:59Z"}}'
const params = new URLSearchParams({
filters: JSON.stringify({
status: "completed",
start_time: {
$gte: "2026-07-01T00:00:00Z",
$lte: "2026-07-22T23:59:59Z",
},
}),
});
const response = await fetch(
`https://backend.botcadence.com/organizations/${organizationId}/conversation-analytics?${params}`,
{ headers: { "X-API-Key": process.env.BOTCADENCE_API_KEY } }
);
import json
import os
import requests
response = requests.get(
f"https://backend.botcadence.com/organizations/{organization_id}/conversation-analytics",
headers={"X-API-Key": os.environ["BOTCADENCE_API_KEY"]},
params={
"filters": json.dumps(
{
"status": "completed",
"start_time": {
"$gte": "2026-07-01T00:00:00Z",
"$lte": "2026-07-22T23:59:59Z",
},
}
)
},
)
{
"status": "success",
"message": "Conversation analytics retrieved successfully",
"data": {
"summary": {
"total_conversations": 150,
"completed_conversations": 98,
"live_conversations": 2,
"total_duration": 18420.5,
"avg_duration": 122.8
},
"daily_conversations": {
"2026-07-01": 12,
"2026-07-02": 18
},
"daily_durations": {
"2026-07-01": 1402.5,
"2026-07-02": 2105.0
}
},
"status_code": 200
}

