How your calls went

curl --request GET \
  --url https://sandbox.voice.miraiminds.co/v2/insights \
  --header 'Authorization: Bearer <token>'

const url = 'https://sandbox.voice.miraiminds.co/v2/insights';
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": "workspace_insights",
  "workspace_id": "ws_01K2M4N8B3C5D7F9G1H3J5K7M9",
  "from": "2026-10-06T18:30:00Z",
  "to": "2026-11-05T09:12:44Z",
  "timezone": "Asia/Kolkata",
  "calls": {
    "total": 1240,
    "in_progress": 2,
    "settled": 1238,
    "connected": 812,
    "not_answered": 301,
    "failed": 38,
    "stopped": 23,
    "other": 64,
    "short": 96,
    "engaged": 503,
    "talk_secs": 98412,
    "talk_p50_secs": 94,
    "connect_rate_pct": 65.6,
    "failure_rate_pct": 3.1,
    "short_rate_pct": 11.8
  },
  "outcomes": {
    "analysed": 790,
    "success": 412,
    "not_success": 318,
    "no_verdict": 60,
    "pending": 9,
    "analysis_failed": 13,
    "success_rate_pct": 56.4
  },
  "money": {
    "billed_paise": 1096500,
    "billed_calls": 820,
    "per_connected_paise": 1350,
    "per_success_paise": 2661,
    "per_talk_minute_paise": 669
  },
  "quality": {
    "calls_measured": 790,
    "v2v_turns": 9120,
    "v2v_p50_ms": 1080,
    "v2v_p95_ms": 1620,
    "first_audio_p50_ms": 2310
  },
  "by_origin": {
    "campaign": {
      "calls": 980,
      "connected": 610,
      "failed": 30,
      "stopped": 21,
      "talk_secs": 71230,
      "billed_paise": 812400,
      "success": 318,
      "not_success": 250
    },
    "inbound": {
      "calls": 160,
      "connected": 142,
      "failed": 4,
      "stopped": 2,
      "talk_secs": 19870,
      "billed_paise": 201300,
      "success": 70,
      "not_success": 55
    },
    "outbound": {
      "calls": 64,
      "connected": 38,
      "failed": 3,
      "stopped": 0,
      "talk_secs": 5210,
      "billed_paise": 64600,
      "success": 18,
      "not_success": 10
    },
    "web": {
      "calls": 30,
      "connected": 18,
      "failed": 1,
      "stopped": 0,
      "talk_secs": 1830,
      "billed_paise": 15300,
      "success": 5,
      "not_success": 3
    },
    "text": {
      "calls": 4,
      "connected": 2,
      "failed": 0,
      "stopped": 0,
      "talk_secs": 120,
      "billed_paise": 900,
      "success": 1,
      "not_success": 0
    },
    "realtime": {
      "calls": 2,
      "connected": 2,
      "failed": 0,
      "stopped": 0,
      "talk_secs": 152,
      "billed_paise": 2000,
      "success": 0,
      "not_success": 0
    }
  },
  "by_agent": [
    {
      "agent_id": "agt_01K2M4P7QRSTVWXYZ0A1B2C3",
      "name": "Service reminder",
      "deleted": false,
      "calls": 1044,
      "connected": 652,
      "failed": 33,
      "stopped": 21,
      "short": 81,
      "talk_secs": 76440,
      "billed_paise": 877000,
      "success": 336,
      "not_success": 260,
      "success_rate_pct": 56.4,
      "v2v_p50_ms": 1060
    },
    {
      "agent_id": "agt_01K2M4Q2W4Y6A8C0E2G4J6L8N0",
      "name": "Front desk",
      "deleted": false,
      "calls": 196,
      "connected": 160,
      "failed": 5,
      "stopped": 2,
      "short": 15,
      "talk_secs": 21972,
      "billed_paise": 219500,
      "success": 76,
      "not_success": 58,
      "success_rate_pct": 56.7,
      "v2v_p50_ms": 1190
    }
  ],
  "daily": [
    {
      "day": "2026-11-04",
      "calls": 61,
      "connected": 40,
      "not_answered": 15,
      "failed": 2,
      "stopped": 1,
      "talk_secs": 4870,
      "billed_paise": 53800,
      "success": 21,
      "v2v_p50_ms": 1070
    },
    {
      "day": "2026-11-05",
      "calls": 22,
      "connected": 15,
      "not_answered": 5,
      "failed": 1,
      "stopped": 0,
      "talk_secs": 1760,
      "billed_paise": 19700,
      "success": 7,
      "v2v_p50_ms": 1100
    }
  ],
  "refused": {
    "total": 12,
    "by_code": {
      "insufficient_balance": 12
    },
    "last_at": "2026-11-02T06:41:09Z"
  },
  "tools": {
    "runs": 640,
    "failed": 9
  },
  "numbers": [
    {
      "number_id": "pn_01K2M4R6T8V0X2Z4B6D8F0H2K4",
      "number": "+918035312390",
      "health_state": "active",
      "attempts": 812,
      "answers": 529,
      "answer_rate_pct": 65.1
    }
  ],
  "inbound_misses": {
    "numbers": 0,
    "calls": 0,
    "last_at": null
  },
  "attention": [
    {
      "code": "wallet",
      "severity": "act",
      "count": 35,
      "last_at": "2026-11-02T06:41:09Z",
      "subject": null
    }
  ]
}

{
  "error": {
    "code": "invalid_request",
    "message": "the window is at most 92 days"
  }
}

{
  "error": {
    "code": "insights_unavailable",
    "message": "could not read the call record; try again shortly"
  }
}

Calls

How your calls went

Every call your workspace made and took in a window, read as a whole: how many connected, how many the agent judged a success, the talk time, what the calls were charged, where they came from (campaigns, incoming calls, one-off calls from the API or the console, browser tests, text, realtime), each agent and number, a day-by-day count, how long callers waited for a reply, and an attention list of things that need you (an empty wallet, a number not added, an agent that could not take its calls). These are the figures on the console’s Overview page.

from/to (RFC 3339, UTC) bound the window; calls count by when they were created, as List calls filters them. Without them it is the last 30 days. The window is at most 92 days. daily is one row per India day (Asia/Kolkata) the window touches.

Every key is always present. A rate or a reply time is null when there is nothing to divide or measure, never 0. Money is call charges only, in paise (the statement has everything else). A 503 means the figures could not be read right now: retry, and don’t read it as a quiet month.

GET

insights

How your calls went

curl --request GET \
  --url https://sandbox.voice.miraiminds.co/v2/insights \
  --header 'Authorization: Bearer <token>'

const url = 'https://sandbox.voice.miraiminds.co/v2/insights';
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": "workspace_insights",
  "workspace_id": "ws_01K2M4N8B3C5D7F9G1H3J5K7M9",
  "from": "2026-10-06T18:30:00Z",
  "to": "2026-11-05T09:12:44Z",
  "timezone": "Asia/Kolkata",
  "calls": {
    "total": 1240,
    "in_progress": 2,
    "settled": 1238,
    "connected": 812,
    "not_answered": 301,
    "failed": 38,
    "stopped": 23,
    "other": 64,
    "short": 96,
    "engaged": 503,
    "talk_secs": 98412,
    "talk_p50_secs": 94,
    "connect_rate_pct": 65.6,
    "failure_rate_pct": 3.1,
    "short_rate_pct": 11.8
  },
  "outcomes": {
    "analysed": 790,
    "success": 412,
    "not_success": 318,
    "no_verdict": 60,
    "pending": 9,
    "analysis_failed": 13,
    "success_rate_pct": 56.4
  },
  "money": {
    "billed_paise": 1096500,
    "billed_calls": 820,
    "per_connected_paise": 1350,
    "per_success_paise": 2661,
    "per_talk_minute_paise": 669
  },
  "quality": {
    "calls_measured": 790,
    "v2v_turns": 9120,
    "v2v_p50_ms": 1080,
    "v2v_p95_ms": 1620,
    "first_audio_p50_ms": 2310
  },
  "by_origin": {
    "campaign": {
      "calls": 980,
      "connected": 610,
      "failed": 30,
      "stopped": 21,
      "talk_secs": 71230,
      "billed_paise": 812400,
      "success": 318,
      "not_success": 250
    },
    "inbound": {
      "calls": 160,
      "connected": 142,
      "failed": 4,
      "stopped": 2,
      "talk_secs": 19870,
      "billed_paise": 201300,
      "success": 70,
      "not_success": 55
    },
    "outbound": {
      "calls": 64,
      "connected": 38,
      "failed": 3,
      "stopped": 0,
      "talk_secs": 5210,
      "billed_paise": 64600,
      "success": 18,
      "not_success": 10
    },
    "web": {
      "calls": 30,
      "connected": 18,
      "failed": 1,
      "stopped": 0,
      "talk_secs": 1830,
      "billed_paise": 15300,
      "success": 5,
      "not_success": 3
    },
    "text": {
      "calls": 4,
      "connected": 2,
      "failed": 0,
      "stopped": 0,
      "talk_secs": 120,
      "billed_paise": 900,
      "success": 1,
      "not_success": 0
    },
    "realtime": {
      "calls": 2,
      "connected": 2,
      "failed": 0,
      "stopped": 0,
      "talk_secs": 152,
      "billed_paise": 2000,
      "success": 0,
      "not_success": 0
    }
  },
  "by_agent": [
    {
      "agent_id": "agt_01K2M4P7QRSTVWXYZ0A1B2C3",
      "name": "Service reminder",
      "deleted": false,
      "calls": 1044,
      "connected": 652,
      "failed": 33,
      "stopped": 21,
      "short": 81,
      "talk_secs": 76440,
      "billed_paise": 877000,
      "success": 336,
      "not_success": 260,
      "success_rate_pct": 56.4,
      "v2v_p50_ms": 1060
    },
    {
      "agent_id": "agt_01K2M4Q2W4Y6A8C0E2G4J6L8N0",
      "name": "Front desk",
      "deleted": false,
      "calls": 196,
      "connected": 160,
      "failed": 5,
      "stopped": 2,
      "short": 15,
      "talk_secs": 21972,
      "billed_paise": 219500,
      "success": 76,
      "not_success": 58,
      "success_rate_pct": 56.7,
      "v2v_p50_ms": 1190
    }
  ],
  "daily": [
    {
      "day": "2026-11-04",
      "calls": 61,
      "connected": 40,
      "not_answered": 15,
      "failed": 2,
      "stopped": 1,
      "talk_secs": 4870,
      "billed_paise": 53800,
      "success": 21,
      "v2v_p50_ms": 1070
    },
    {
      "day": "2026-11-05",
      "calls": 22,
      "connected": 15,
      "not_answered": 5,
      "failed": 1,
      "stopped": 0,
      "talk_secs": 1760,
      "billed_paise": 19700,
      "success": 7,
      "v2v_p50_ms": 1100
    }
  ],
  "refused": {
    "total": 12,
    "by_code": {
      "insufficient_balance": 12
    },
    "last_at": "2026-11-02T06:41:09Z"
  },
  "tools": {
    "runs": 640,
    "failed": 9
  },
  "numbers": [
    {
      "number_id": "pn_01K2M4R6T8V0X2Z4B6D8F0H2K4",
      "number": "+918035312390",
      "health_state": "active",
      "attempts": 812,
      "answers": 529,
      "answer_rate_pct": 65.1
    }
  ],
  "inbound_misses": {
    "numbers": 0,
    "calls": 0,
    "last_at": null
  },
  "attention": [
    {
      "code": "wallet",
      "severity": "act",
      "count": 35,
      "last_at": "2026-11-02T06:41:09Z",
      "subject": null
    }
  ]
}

{
  "error": {
    "code": "invalid_request",
    "message": "the window is at most 92 days"
  }
}

{
  "error": {
    "code": "insights_unavailable",
    "message": "could not read the call record; try again shortly"
  }
}

Authorizations

Authorization

string

header

required

Your workspace secret key, sk_live_ followed by 32 hex characters. Create one in the console under Developers.

Query Parameters

from

string

Response

The last 30 days

GET /v2/insights: how this workspace's calls created in [from, to) went. Every key is always present; a rate or per-unit cost is null when its denominator is 0. Counts are calls, one per call id; money is call charges in paise.

attention

object[]

required

Show child attributes

by_agent

object[]

required

Show child attributes

by_origin

object

required

Show child attributes

calls

object

required

Show child attributes

daily

object[]

required

Show child attributes

from

string<date-time>

required

inbound_misses

object

required

Show child attributes

language

object

required

Show child attributes

money

object

required

Show child attributes

numbers

object[]

required

Show child attributes

object

enum<string>

required

Available options:

workspace_insights

outcomes

object

required

Show child attributes

quality

object

required

Show child attributes

refused

object

required

Show child attributes

timezone

string

required

string<date-time>

required

tools

object

required

Show child attributes

workspace_id

string

required

Get started

Agents

Calls

Flows

Tools and secrets

Campaigns

Do-not-call list

Phone numbers

Phone pools

Telephony

Transcriptions

Speech to text

Text to speech

Wallet

Webhooks

Sub-workspaces

Reference

How your calls went

Authorizations

Query Parameters

Response