Weekly call trends

GET

https://api.smallest.ai/atoms/v1/analytics/weekly-trends

GET

/atoms/v1/analytics/weekly-trends

1 import requests
2 
3 url = "https://api.smallest.ai/atoms/v1/analytics/weekly-trends"
4 
5 payload = {}
6 headers = {
7     "Authorization": "Bearer <token>",
8     "Content-Type": "application/json"
9 }
10 
11 response = requests.get(url, json=payload, headers=headers)
12 
13 print(response.json())

1 {
2   "success": true,
3   "data": {
4     "orgId": "org_9f8b7c6d5e4a3b2c1d0e",
5     "weeks": [
6       {
7         "weekStart": "2023-01-09",
8         "totalCalls": 245,
9         "answeredCalls": 198,
10         "pickupRate": 0.81,
11         "avgDuration": 320,
12         "medianDuration": 275,
13         "p90Duration": 600,
14         "shortCallsPercent": 0.15,
15         "longCallsPercent": 0.1
16       },
17       {
18         "weekStart": "2023-01-16",
19         "totalCalls": 310,
20         "answeredCalls": 260,
21         "pickupRate": 0.84,
22         "avgDuration": 340,
23         "medianDuration": 290,
24         "p90Duration": 620,
25         "shortCallsPercent": 0.12,
26         "longCallsPercent": 0.13
27       }
28     ],
29     "period": {
30       "from": "2023-01-09",
31       "to": "2023-01-22"
32     }
33   }
34 }

Returns per-week call performance metrics including volume, pickup rate, and duration percentiles (p50, p90). Each week starts on Monday.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Query parameters

agentIdstringOptional

Comma-separated agent IDs to filter results

campaignIdstringOptional

Campaign ID to filter results

callTypestringOptional

Type of call to filter (e.g. inbound, outbound)

dateFromdatetimeOptional

Start of date range (ISO 8601)

dateTodatetimeOptional

End of date range (ISO 8601)

Response

Weekly performance metrics

successboolean

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error