---
title: "Calls dashboard — funnel KPIs + last offers, per direction, period-over-period"
method: GET
path: "/v3/phone-call-analysis/dashboard"
tags: ["v3", "phone-call-analysis"]
---

# Calls dashboard — funnel KPIs + last offers, per direction, period-over-period

`GET /v3/phone-call-analysis/dashboard`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v3/phone-call-analysis/dashboard`
- Auth: HTTP bearer

## Query parameters

- `period_days` integer, nullable: Window size in days. KPIs and last-offers come from the trailing window; deltas come from the prior window of the same length. Mutually exclusive with start_datetime + end_datetime_exclusive. Omit all window params to default to 30 days.
- `start_datetime` string, date-time, nullable: Inclusive window start (timezone-aware ISO-8601). Requires end_datetime_exclusive; mutually exclusive with period_days.
- `end_datetime_exclusive` string, date-time, nullable: Exclusive window end (timezone-aware ISO-8601). Requires start_datetime; mutually exclusive with period_days.
- `agent_ids` string[], nullable: Scope to calls handled by these AI agents. Omit for all agents.

## Headers

- `mentium-workspace-id` string, nullable

## Response `200`

Successful Response

- PhoneCallDashboardResponse
  - `period_days` integer, required
  - `agent_ids` string[]
  - `range_start` string, date-time, required
  - `range_end` string, date-time, required
  - `sections` PhoneCallDashboardSection[], required
    - `direction` string, required
    - `current` PhoneCallDashboardKpis, required: Aggregated counts for one (direction, window) slice.
      - `total_calls` integer, required
      - `tagged_calls` integer, required
      - `load_identified` integer, required
      - `carrier_identified` integer, required
      - `offer_discussed` integer, required
      - `offer_accepted` integer, required
      - `resolved` integer, required
      - `escalated` integer, required
      - `callback_requested` integer, required
      - `objections` integer, required
      - `carrier_verified` integer, required
      - `carrier_rejected` integer, required
      - `unique_loads` integer, required
    - `previous` PhoneCallDashboardKpis, required: Aggregated counts for one (direction, window) slice.
      - `total_calls` integer, required
      - `tagged_calls` integer, required
      - `load_identified` integer, required
      - `carrier_identified` integer, required
      - `offer_discussed` integer, required
      - `offer_accepted` integer, required
      - `resolved` integer, required
      - `escalated` integer, required
      - `callback_requested` integer, required
      - `objections` integer, required
      - `carrier_verified` integer, required
      - `carrier_rejected` integer, required
      - `unique_loads` integer, required
    - `last_offers` PhoneCallDashboardLastOffer[], required
      - `id` string, required
      - `received_at` string, date-time, required
      - `load` string, nullable
      - `carrier` string, nullable
      - `carrier_rate_amount` number, nullable
      - `status` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mentium/apis/mentium-api.md) - [All operations](https://skmtc.dev/mentium/apis/mentium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mentium/apis/mentium-api/revisions/b4ed8e59432e?raw)