---
title: "List conversation analytics"
method: GET
path: "/v1/analytics/inbox/conversations"
tags: ["Inbox Analytics"]
---

# List conversation analytics

`GET /v1/analytics/inbox/conversations`

Per-conversation listing with per-row totals + first/last message
timestamps. The inbox analog of GET /v1/analytics (posts listing) —
same filter shape, same pagination, same sort/order semantics.
Use as the entry point for the per-conversation analytics drawer
at /v1/analytics/inbox/conversations/{conversationId}.

Rows are enriched with the conversation's participant info
(`participantName`, `participantUsername`, `participantPicture`)
and last-message preview by joining the Conversation document
scoped to the caller's team. Max date range is 365 days.

## Query parameters

- `fromDate` string, date, required
- `toDate` string, date
- `profileId` string
- `platform` string
- `accountId` string
- `source` string
- `limit` integer
- `page` integer
- `sortBy` 'lastMessageAt' | 'firstMessageAt' | 'totalMessages' | 'received' | 'sent' | 'read' | 'failed'
- `order` 'asc' | 'desc'

## Response `200`

Paginated conversation analytics list

- object
  - `success` boolean
  - `from` string, date
  - `to` string, date, nullable
  - `items` object[]
    - `conversationId` string — The platformConversationId (the same identity used by metadata.conversationId)
    - `mongoId` string, nullable — The Conversation document _id, when a matching doc exists
    - `accountId` string
    - `platform` string
    - `participantName` string, nullable
    - `participantUsername` string, nullable
    - `participantPicture` string, nullable
    - `lastMessage` string, nullable — Cached preview from the Conversation doc
    - `totalMessages` integer
    - `received` integer
    - `sent` integer
    - `read` integer
    - `failed` integer
    - `firstMessageAt` string, date-time
    - `lastMessageAt` string, date-time
  - `pagination` object
    - `page` integer
    - `limit` integer
    - `total` integer
    - `totalPages` integer
    - `hasMore` boolean

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/revisions/875093317201/schema)