Agents
Read what an agent did
Everything the agent’s page in the console shows, for one scope: calls by where they came from, how they went, what its calls recorded, pick-up per number, its tools, the call-backs it owes, and its notes for you. Every figure comes from stored calls.
The scope is from and to (RFC 3339, at most 31 days; today in the workspace’s time zone by default), origin and, for one campaign, campaign_id. all leaves out tests. Money is in paise. When the figures can’t be read it answers 503 home_unavailable, never zeros. It answers 404 until the agent page is on for your workspace.
GET
/
v2
/
agents
/
{agent_id}
/
home
Read what an agent did
curl --request GET \
--url https://sandbox.voice.miraiminds.co/v2/agents/{agent_id}/home \
--header 'Authorization: Bearer <token>'import requests
url = "https://sandbox.voice.miraiminds.co/v2/agents/{agent_id}/home"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const url = 'https://sandbox.voice.miraiminds.co/v2/agents/{agent_id}/home';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"object": "agent_home",
"agent_id": "agt_01K2M4P7QRSTVWXYZ0A1B2C3",
"from": "2026-11-14T18:30:00Z",
"to": "2026-11-15T18:30:00Z",
"timezone": "Asia/Kolkata",
"scope": {
"origin": "all",
"campaign_id": null
},
"has_calls_ever": true,
"legacy_origin_rows": false,
"origins": [
{
"origin": "api",
"calls": 1391
},
{
"origin": "inbound",
"calls": 67
},
{
"origin": "campaign",
"calls": 0,
"campaigns": []
},
{
"origin": "callback",
"calls": 4
},
{
"origin": "web",
"calls": 0
},
{
"origin": "test",
"calls": 9
}
],
"work": {
"calls": 1458,
"dialled": 1391,
"received": 67,
"connected": 809,
"not_reached": 640,
"failed_platform": 3,
"failed_carrier": 6,
"talk_secs": 90600,
"billed_paise": 151000,
"first_call_at": "2026-11-15T01:42:00Z",
"last_call_at": "2026-11-15T11:40:31Z",
"lines": {
"bin_secs": 120,
"days": [
{
"day": "2026-11-15",
"values": [
0,
0,
3,
7
]
}
]
}
},
"outcomes": {
"success": 96,
"callback": 41,
"talked": 672,
"not_reached": 640,
"failed_platform": 3,
"failed_carrier": 6,
"waited_too_long": 0,
"cleared": 0,
"judged": true
},
"recorded": [
{
"field": "interested",
"title": "Interested",
"values": [
{
"value": "yes",
"calls": 120
}
],
"other": 12,
"total": 809
}
],
"reach": {
"daily": [
{
"day": "2026-11-14",
"dialled": 900,
"answered": 558
}
],
"last_24h": {
"dialled": 1391,
"answered": 668
},
"prior_7d": {
"dialled": 6100,
"answered": 3721
},
"calls_from": {
"kind": "number",
"phone_number_id": "phn_01K2M4",
"number": "+918047351142",
"pool_id": null,
"pool_name": null
},
"numbers": [
{
"phone_number_id": "phn_01K2M4",
"number": "+918047351142",
"health_state": "active",
"resting_until": null,
"cooling_until": null,
"answer_rate_7d": 0.48,
"attempts_today": 1391,
"answers_today": 668
}
]
},
"tools": [
{
"name": "create_booking",
"kind": "http",
"phase": "on_call",
"runs": 40,
"failed": 12,
"p50_ms": 820,
"max_ms": 4100,
"last_error": "timeout",
"last_error_at": "2026-11-15T11:20:00Z",
"last_failed_call_id": "call_01K2M4RB8CDEFGHJKMNPQRST"
}
],
"tools_missing": [
{
"name": "get_complaint_status",
"count": 7
}
],
"promised": {
"open": 2,
"today": 1,
"overdue": 0,
"due": [
{
"id": "cb_01K2M4",
"at": "2026-11-15T13:00:00Z",
"to": "+919812345678",
"parent_call_id": "call_01K2M4QZ7ABCDEFGHJKMNPQR",
"status": "scheduled",
"note": "After office hours"
}
]
},
"delivery": {
"failed_in_row": 0,
"last_error": null
},
"money": {
"wallet_paise": 2500000,
"spend_last_hour_paise": 21000
},
"rules": {
"working_hours": null,
"queue_ttl_secs": 1800,
"lines_guaranteed": 20
},
"company": null,
"notes": [
{
"key": "tool_failing",
"weight": 12,
"figure": {
"value": "12 of 40",
"label": "runs failed",
"was": null
},
"text": "My create_booking tool failed 12 of 40 times. Last error: timed out.",
"action": {
"kind": "open_tool",
"label": "Open tool",
"tool": "create_booking"
},
"proof": {
"region": "tools"
}
}
],
"generated_at": "2026-11-15T11:42:10Z"
}Authorizations
Query Parameters
Response
Today
⌘I
Read what an agent did
curl --request GET \
--url https://sandbox.voice.miraiminds.co/v2/agents/{agent_id}/home \
--header 'Authorization: Bearer <token>'import requests
url = "https://sandbox.voice.miraiminds.co/v2/agents/{agent_id}/home"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const url = 'https://sandbox.voice.miraiminds.co/v2/agents/{agent_id}/home';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"object": "agent_home",
"agent_id": "agt_01K2M4P7QRSTVWXYZ0A1B2C3",
"from": "2026-11-14T18:30:00Z",
"to": "2026-11-15T18:30:00Z",
"timezone": "Asia/Kolkata",
"scope": {
"origin": "all",
"campaign_id": null
},
"has_calls_ever": true,
"legacy_origin_rows": false,
"origins": [
{
"origin": "api",
"calls": 1391
},
{
"origin": "inbound",
"calls": 67
},
{
"origin": "campaign",
"calls": 0,
"campaigns": []
},
{
"origin": "callback",
"calls": 4
},
{
"origin": "web",
"calls": 0
},
{
"origin": "test",
"calls": 9
}
],
"work": {
"calls": 1458,
"dialled": 1391,
"received": 67,
"connected": 809,
"not_reached": 640,
"failed_platform": 3,
"failed_carrier": 6,
"talk_secs": 90600,
"billed_paise": 151000,
"first_call_at": "2026-11-15T01:42:00Z",
"last_call_at": "2026-11-15T11:40:31Z",
"lines": {
"bin_secs": 120,
"days": [
{
"day": "2026-11-15",
"values": [
0,
0,
3,
7
]
}
]
}
},
"outcomes": {
"success": 96,
"callback": 41,
"talked": 672,
"not_reached": 640,
"failed_platform": 3,
"failed_carrier": 6,
"waited_too_long": 0,
"cleared": 0,
"judged": true
},
"recorded": [
{
"field": "interested",
"title": "Interested",
"values": [
{
"value": "yes",
"calls": 120
}
],
"other": 12,
"total": 809
}
],
"reach": {
"daily": [
{
"day": "2026-11-14",
"dialled": 900,
"answered": 558
}
],
"last_24h": {
"dialled": 1391,
"answered": 668
},
"prior_7d": {
"dialled": 6100,
"answered": 3721
},
"calls_from": {
"kind": "number",
"phone_number_id": "phn_01K2M4",
"number": "+918047351142",
"pool_id": null,
"pool_name": null
},
"numbers": [
{
"phone_number_id": "phn_01K2M4",
"number": "+918047351142",
"health_state": "active",
"resting_until": null,
"cooling_until": null,
"answer_rate_7d": 0.48,
"attempts_today": 1391,
"answers_today": 668
}
]
},
"tools": [
{
"name": "create_booking",
"kind": "http",
"phase": "on_call",
"runs": 40,
"failed": 12,
"p50_ms": 820,
"max_ms": 4100,
"last_error": "timeout",
"last_error_at": "2026-11-15T11:20:00Z",
"last_failed_call_id": "call_01K2M4RB8CDEFGHJKMNPQRST"
}
],
"tools_missing": [
{
"name": "get_complaint_status",
"count": 7
}
],
"promised": {
"open": 2,
"today": 1,
"overdue": 0,
"due": [
{
"id": "cb_01K2M4",
"at": "2026-11-15T13:00:00Z",
"to": "+919812345678",
"parent_call_id": "call_01K2M4QZ7ABCDEFGHJKMNPQR",
"status": "scheduled",
"note": "After office hours"
}
]
},
"delivery": {
"failed_in_row": 0,
"last_error": null
},
"money": {
"wallet_paise": 2500000,
"spend_last_hour_paise": 21000
},
"rules": {
"working_hours": null,
"queue_ttl_secs": 1800,
"lines_guaranteed": 20
},
"company": null,
"notes": [
{
"key": "tool_failing",
"weight": 12,
"figure": {
"value": "12 of 40",
"label": "runs failed",
"was": null
},
"text": "My create_booking tool failed 12 of 40 times. Last error: timed out.",
"action": {
"kind": "open_tool",
"label": "Open tool",
"tool": "create_booking"
},
"proof": {
"region": "tools"
}
}
],
"generated_at": "2026-11-15T11:42:10Z"
}