Call Metrics | Smallest AI Docs

Access detailed information about every call through the SDK.

Getting Recent Calls

Fetch a paginated list of calls:

1 from smallestai.atoms.call import Call
2 
3 call = Call()
4 
5 calls = call.get_calls(limit=5)
6 
7 for log in calls["data"]["logs"]:
8     print(f"{log['callId']}: {log['status']} ({log['duration']}s)")

The response includes pagination info:

1 {
2   "status": true,
3   "data": {
4     "logs": [...],
5     "pagination": {
6       "total": 94,
7       "page": 1,
8       "hasMore": true,
9       "limit": 5
10     }
11   }
12 }

Filtering Calls

Narrow results using filter parameters:

1 from smallestai.atoms.call import Call
2 
3 call = Call()
4 
5 # By status
6 completed = call.get_calls(status="completed", limit=10)
7 
8 # By agent
9 agent_calls = call.get_calls(agent_id="696ddd281ea16a73cb8aafbe", limit=10)
10 
11 # By campaign
12 campaign_calls = call.get_calls(campaign_id="696ddd2a04ff172dbd8eddad", limit=10)
13 
14 # By call type
15 outbound = call.get_calls(call_type="telephony_outbound", limit=10)
16 
17 # By phone number
18 found = call.get_calls(search="+916366821717", limit=10)

Filter Parameters

Parameter	Type	Description
`agent_id`	string	Filter by agent ID
`campaign_id`	string	Filter by campaign ID
`page`	int	Page number (default: 1)
`limit`	int	Results per page (default: 10)
`status`	string	completed, failed, in_progress, no_answer, busy
`call_type`	string	telephony_inbound, telephony_outbound, chat
`search`	string	Match callId, fromNumber, or toNumber

Getting Single Call Details

Retrieve complete details for one call:

1 from smallestai.atoms.call import Call
2 
3 call = Call()
4 
5 call_id = "CALL-1768807723178-4561d0"
6 details = call.get_call(call_id)
7 
8 data = details["data"]
9 print(f"Status: {data['status']}")
10 print(f"Duration: {data['duration']} seconds")
11 print(f"From: {data['from']} → To: {data['to']}")

Response Fields

Field	Description
`callId`	Unique call identifier
`status`	completed, failed, in_progress, no_answer
`duration`	Length in seconds
`type`	telephony_outbound, telephony_inbound, chat
`from` / `to`	Phone numbers
`transcript`	Array of conversation messages
`recordingUrl`	Mono audio file URL
`recordingDualUrl`	Stereo audio file URL
`callCost`	Cost in credits
`disconnectionReason`	user_hangup, agent_hangup, timeout
`postCallAnalytics`	AI summary and extracted metrics

Accessing Transcripts

The transcript is an array of messages with speaker roles:

1 details = call.get_call(call_id)
2 transcript = details["data"].get("transcript", [])
3 
4 for msg in transcript:
5     print(f"{msg['role']}: {msg['content']}")

Accessing Recordings

Recordings are available after the call completes:

1 details = call.get_call(call_id)
2 data = details["data"]
3 
4 if data.get("recordingUrl"):
5     print(f"Mono: {data['recordingUrl']}")
6 
7 if data.get("recordingDualUrl"):
8     print(f"Stereo: {data['recordingDualUrl']}")

Batch Search

Fetch multiple calls at once with search_calls():

1 call_ids = ["CALL-1768807723178-4561d0", "CALL-1768807723177-4561cd"]
2 result = call.search_calls(call_ids)
3 
4 print(f"Found {result['data']['total']} of {len(call_ids)} calls")

Maximum 100 call IDs per request.

Performance Metrics

Each call includes latency breakdowns:

1 details = call.get_call(call_id)
2 data = details["data"]
3 
4 print(f"Transcriber: {data.get('average_transcriber_latency')}ms")
5 print(f"Agent (LLM): {data.get('average_agent_latency')}ms")
6 print(f"Synthesizer: {data.get('average_synthesizer_latency')}ms")

Metric	Description
`average_transcriber_latency`	Speech-to-text processing time
`average_agent_latency`	LLM response generation time
`average_synthesizer_latency`	Text-to-speech processing time

SDK Reference

Method	Description
`get_calls(...)`	List calls with optional filters
`get_call(call_id)`	Get single call with all details
`search_calls(call_ids)`	Batch fetch by call IDs

Tips

What's the difference between status and disconnectionReason?

status is the outcome (completed, failed). disconnectionReason explains why it ended:

user_hangup — Caller hung up
agent_hangup — Agent ended the call
dial_no_answer — No pickup
timeout — Call timeout

When are recordings available?

Recordings generate after the call ends. They may take a few seconds to appear. Check if recordingUrl is non-empty before accessing.

How do I calculate average call duration?

Fetch calls with get_calls(), then calculate:

1 calls = call.get_calls(status="completed", limit=100)
2 durations = [log["duration"] for log in calls["data"]["logs"]]
3 avg = sum(durations) / len(durations)

How do I find calls for a specific phone number?

Use the search parameter:

1 calls = call.get_calls(search="+916366821717")

How do I get calls from a specific date range?

Currently, use pagination and filter client-side by createdAt. Date range filters are coming soon.