Query analytics
Returns only the requested tenant-scoped analytics sections under analytics:read and resolves their shared time window once. It performs no writes and is safe to retry with the same body.
POST
/
analytics
/
query
Query analytics
curl --request POST \
--url https://api.getarbol.com/v1/analytics/query \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"sections": [
"summary",
"chart"
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({sections: ['summary', 'chart']})
};
fetch('https://api.getarbol.com/v1/analytics/query', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.getarbol.com/v1/analytics/query"
payload = { "sections": ["summary", "chart"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"window": {
"from": "2026-08-29T14:30:00Z",
"granularity": "day",
"timezone": "UTC",
"to": "2026-08-29T14:30:00Z"
},
"agentPerformance": [
{
"agentId": "agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31",
"averageDurationSeconds": 1,
"conversations": 4503599627370495,
"lastActiveAt": "2026-08-29T14:30:00Z",
"name": "<string>",
"successRate": 0.5
}
],
"chart": {
"metric": "conversations",
"points": [
{
"date": "<string>",
"value": 123
}
]
},
"sentimentBreakdown": [
{
"count": 4503599627370495,
"key": "<string>"
}
],
"statusBreakdown": [
{
"count": 4503599627370495,
"key": "<string>"
}
],
"summary": {
"averageDurationSeconds": 1,
"contacts": 4503599627370495,
"conversations": 4503599627370495,
"messages": 4503599627370495,
"successRate": 0.5
}
}{
"defined": true,
"inferable": true,
"code": "BAD_REQUEST",
"status": 400,
"message": "<string>",
"data": {
"issues": [
{
"code": "custom",
"message": "<string>",
"path": [
"<string>"
]
}
],
"truncated": true
}
}{
"defined": true,
"inferable": true,
"code": "UNAUTHORIZED",
"status": 401,
"message": "<string>",
"data": "<unknown>"
}{
"defined": true,
"inferable": true,
"code": "FORBIDDEN",
"status": 403,
"message": "<string>",
"data": {
"missingPermissions": [
"agents:read"
]
}
}{
"code": "PAYLOAD_TOO_LARGE",
"defined": false,
"inferable": false,
"message": "<string>",
"data": "<unknown>"
}{
"code": "UNSUPPORTED_MEDIA_TYPE",
"defined": false,
"inferable": false,
"message": "<string>",
"data": "<unknown>"
}Authorizations
userOAuthmachineOAuth
Organization-scoped Auth0 user access token issued to an approved first-party client or exchanged by a trusted OBO resource server.
Body
application/json
A bounded set of analytics projections over one shared half-open time window.
Required array length:
1 - 5 elementsTyped projection requested from the analytics query.
Available options:
summary, chart, statusBreakdown, sentimentBreakdown, agentPerformance Opaque Arbol resource identifier; the endpoint and tenant-scoped lookup determine its resource type.
Maximum string length:
64Pattern:
^[a-z][a-z0-9]{1,15}_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$Example:
"agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31"
Conversation transport family.
Available options:
voice, whatsapp, web Example:
"voice"
ISO 8601 timestamp with an explicit UTC offset.
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$Example:
"2026-08-29T14:30:00Z"
Bucket size used for an analytics chart window.
Available options:
hour, day, week, month Example:
"day"
Measure aggregated into analytics chart points.
Available options:
conversations, messages, duration, success_rate Example:
"conversations"
Allowed value:
"UTC"ISO 8601 timestamp with an explicit UTC offset.
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$Example:
"2026-08-29T14:30:00Z"
Response
OK
Only the requested analytics sections, all resolved over the same returned window.
Show child attributes
Show child attributes
Maximum array length:
500Show child attributes
Show child attributes
Show child attributes
Show child attributes
Maximum array length:
50Show child attributes
Show child attributes
Maximum array length:
50Show child attributes
Show child attributes
Headline Conversation counts and rates over the requested window.
Show child attributes
Show child attributes
⌘I
Query analytics
curl --request POST \
--url https://api.getarbol.com/v1/analytics/query \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"sections": [
"summary",
"chart"
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({sections: ['summary', 'chart']})
};
fetch('https://api.getarbol.com/v1/analytics/query', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.getarbol.com/v1/analytics/query"
payload = { "sections": ["summary", "chart"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"window": {
"from": "2026-08-29T14:30:00Z",
"granularity": "day",
"timezone": "UTC",
"to": "2026-08-29T14:30:00Z"
},
"agentPerformance": [
{
"agentId": "agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31",
"averageDurationSeconds": 1,
"conversations": 4503599627370495,
"lastActiveAt": "2026-08-29T14:30:00Z",
"name": "<string>",
"successRate": 0.5
}
],
"chart": {
"metric": "conversations",
"points": [
{
"date": "<string>",
"value": 123
}
]
},
"sentimentBreakdown": [
{
"count": 4503599627370495,
"key": "<string>"
}
],
"statusBreakdown": [
{
"count": 4503599627370495,
"key": "<string>"
}
],
"summary": {
"averageDurationSeconds": 1,
"contacts": 4503599627370495,
"conversations": 4503599627370495,
"messages": 4503599627370495,
"successRate": 0.5
}
}{
"defined": true,
"inferable": true,
"code": "BAD_REQUEST",
"status": 400,
"message": "<string>",
"data": {
"issues": [
{
"code": "custom",
"message": "<string>",
"path": [
"<string>"
]
}
],
"truncated": true
}
}{
"defined": true,
"inferable": true,
"code": "UNAUTHORIZED",
"status": 401,
"message": "<string>",
"data": "<unknown>"
}{
"defined": true,
"inferable": true,
"code": "FORBIDDEN",
"status": 403,
"message": "<string>",
"data": {
"missingPermissions": [
"agents:read"
]
}
}{
"code": "PAYLOAD_TOO_LARGE",
"defined": false,
"inferable": false,
"message": "<string>",
"data": "<unknown>"
}{
"code": "UNSUPPORTED_MEDIA_TYPE",
"defined": false,
"inferable": false,
"message": "<string>",
"data": "<unknown>"
}