Phone number trends

GET

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

GET

/atoms/v1/analytics/phone-number-trends

1 import requests
2 
3 url = "https://api.smallest.ai/atoms/v1/analytics/phone-number-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     "trends": [
6       {
7         "phoneNumber": "+14155552671",
8         "dataPoints": [
9           {
10             "date": "2023-01-15",
11             "totalCalls": 120,
12             "answeredCalls": 90,
13             "pickupRate": 0.75
14           },
15           {
16             "date": "2023-01-16",
17             "totalCalls": 135,
18             "answeredCalls": 100,
19             "pickupRate": 0.74
20           },
21           {
22             "date": "2023-01-17",
23             "totalCalls": 110,
24             "answeredCalls": 85,
25             "pickupRate": 0.77
26           }
27         ]
28       },
29       {
30         "phoneNumber": "+14155559876",
31         "dataPoints": [
32           {
33             "date": "2023-01-15",
34             "totalCalls": 80,
35             "answeredCalls": 60,
36             "pickupRate": 0.75
37           },
38           {
39             "date": "2023-01-16",
40             "totalCalls": 95,
41             "answeredCalls": 70,
42             "pickupRate": 0.74
43           },
44           {
45             "date": "2023-01-17",
46             "totalCalls": 100,
47             "answeredCalls": 80,
48             "pickupRate": 0.8
49           }
50         ]
51       }
52     ],
53     "period": {
54       "from": "2023-01-15",
55       "to": "2023-01-17"
56     }
57   }
58 }

Returns per-phone-number call volume and pickup rate as a daily timeseries, useful for spotting number-level degradation over time.

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

Per-number daily timeseries

successboolean

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error