---
title: "Get conversations analytics"
method: GET
path: "/orgs/analytics/conversations"
tags: ["Analytics and logs"]
---

# Get conversations analytics

`GET /orgs/analytics/conversations`

## Request

- Base URL: `https://api.useinvent.com`
- URL: `https://api.useinvent.com/orgs/analytics/conversations`
- Auth: HTTP bearer

Everything the Conversations analytics view renders, in one call: KPIs, the handoff flow, per-channel volume, message split, resolution and CSAT trends, and the takeover-time distribution. The channel filter applies to conversation and message volume; outcome metrics (resolution, handoffs, CSAT) are not channel-segmented.

## Query parameters

- `from_date` string, date-time, nullable
- `to_date` string, date-time, nullable
- `interval` 'hour' | 'day' | 'week' | 'month' | 'year'
- `timezone` string: IANA timezone identifier (e.g. America/New_York)
- `assistant_id` string
- `channel_id` 'internal' | 'org' | 'agent' | 'custom' | 'whatsapp_bot' | 'messenger_bot' | 'instagram_dm' | 'tiktok_dm' | 'telegram_bot' | 'slack_bot' | 'teams_bot' | 'gmail' | 'outlook' | 'twilio' | 'telnyx' | 'email' | 'smpp': The channel type
- `member_id` string

## Response `200`

Conversations analytics for the specified organization.

- ConversationsAnalyticsSchema: Everything the Conversations analytics view renders, in one payload.
  - `kpis` ConversationsKpisSchema, required
    - `conversations` number, required
    - `conversations_previous` number, required
    - `ai_resolution_rate` number, nullable, required
    - `handoff_rate` number, nullable, required
    - `median_takeover_seconds` number, nullable, required
    - `p90_takeover_seconds` number, nullable, required
    - `median_resolution_seconds` number, nullable, required
    - `p90_resolution_seconds` number, nullable, required
    - `csat_average` number, nullable, required
    - `csat_responses` number, required
  - `flow` ConversationsFlowSchema, required: Where conversations created in the period ended up. Unanswered handoffs are reported, never dropped.
    - `created` number, required
    - `resolved_by_ai` number, required
    - `resolved_by_team` number, required
    - `handed_off` number, required
    - `human_replied` number, required
    - `unanswered` number, required
    - `awaiting_team` number, required
    - `still_open` number, required
  - `conversations_by_channel` NamedSeriesSchema[], required
    - `key` string, required
    - `points` SeriesPointSchema[], required
      - `date` string, date-time, nullable, required
      - `amount` number, required
  - `messages` NamedSeriesSchema[], required
    - `key` string, required
    - `points` SeriesPointSchema[], required
      - `date` string, date-time, nullable, required
      - `amount` number, required
  - `messages_by_channel` ConversationsMessagesByChannelItemSchema[], required
    - `channel_type` 'internal' | 'org' | 'agent' | 'custom' | 'whatsapp_bot' | 'messenger_bot' | 'instagram_dm' | 'tiktok_dm' | 'telegram_bot' | 'slack_bot' | 'teams_bot' | 'gmail' | 'outlook' | 'twilio' | 'telnyx' | 'email' | 'smpp', required: The channel type
    - `received` number, required
    - `ai` number, required
    - `agent` number, required
  - `messages_by_channel_series` NamedSeriesSchema[], required
    - `key` string, required
    - `points` SeriesPointSchema[], required
      - `date` string, date-time, nullable, required
      - `amount` number, required
  - `resolution` NamedSeriesSchema[], required
    - `key` string, required
    - `points` SeriesPointSchema[], required
      - `date` string, date-time, nullable, required
      - `amount` number, required
  - `handoff` NamedSeriesSchema[], required
    - `key` string, required
    - `points` SeriesPointSchema[], required
      - `date` string, date-time, nullable, required
      - `amount` number, required
  - `csat` SeriesPointSchema[], required
    - `date` string, date-time, nullable, required
    - `amount` number, required
  - `csat_distribution` ConversationsCsatBucketSchema[], required
    - `score` number, required
    - `count` number, required
  - `takeover_distribution` ConversationsDurationBucketSchema[], required
    - `lt_seconds` number, nullable, required
    - `count` number, required
  - `resolution_distribution` ConversationsDurationBucketSchema[], required
    - `lt_seconds` number, nullable, required
    - `count` number, required
  - `team` ConversationsTeamMemberSchema[], required
    - `id` string, required
    - `kind` 'assistant' | 'member' | 'unassigned', required
    - `name` string, required
    - `avatar_url` string, nullable, required
    - `conversations` number, required
    - `resolved` number, required

---

[API](https://skmtc.dev/useinvent/apis/invent-api.md) · [All operations](https://skmtc.dev/useinvent/apis/invent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useinvent/apis/invent-api/revisions/98824f3fde82?raw)