Dashboard summary KPIs

GET

https://api.smallest.ai/atoms/v1/analytics/summary

GET

/atoms/v1/analytics/summary

1 import requests
2 
3 url = "https://api.smallest.ai/atoms/v1/analytics/summary"
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     "totalCalls": {
6       "current": 1250,
7       "previous": 1100,
8       "percentChange": 13.64
9     },
10     "pickupRate": {
11       "current": 0.78,
12       "previous": 0.75,
13       "percentChange": 4
14     },
15     "avgDurationMs": {
16       "current": 320000,
17       "previous": 300000,
18       "percentChange": 6.67
19     },
20     "medianDurationMs": 280000,
21     "totalDurationMs": {
22       "current": 400000000,
23       "previous": 330000000,
24       "percentChange": 21.21
25     },
26     "uniqueUsersReached": {
27       "current": 850,
28       "previous": 800,
29       "percentChange": 6.25
30     },
31     "totalCost": {
32       "current": 12500.5,
33       "previous": 11500,
34       "percentChange": 8.7
35     },
36     "period": {
37       "from": "2024-05-01",
38       "to": "2024-05-31"
39     },
40     "previousPeriod": {
41       "from": "2024-04-01",
42       "to": "2024-04-30"
43     }
44   }
45 }

Returns high-level KPI metrics with current period value, previous period value, and percent change for trend comparison.

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

KPI summary

successboolean

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error