---
title: "Get top accounts by inbox volume"
method: GET
path: "/v1/analytics/inbox/top-accounts"
tags: ["Inbox Analytics"]
---

# Get top accounts by inbox volume

`GET /v1/analytics/inbox/top-accounts`

Leaderboard of social accounts by inbox message volume. Decorates
each row with display labels from the live SocialAccount record
(so the UI shows username + displayName, not just an ID). Accounts
that no longer map to a SocialAccount surface as "(disconnected)"
so the row stays visible. Max date range is 365 days.

## Query parameters

- `fromDate` string, date, required
- `toDate` string, date
- `profileId` string
- `platform` string
- `source` string
- `limit` integer

## Response `200`

Top accounts leaderboard

- object
  - `success` boolean
  - `from` string, date
  - `to` string, date, nullable
  - `accounts` object[]
    - `accountId` string
    - `platform` string
    - `displayName` string — (disconnected) when the SocialAccount no longer exists
    - `username` string
    - `received` integer
    - `sent` integer
    - `total` integer
    - `conversations` integer
    - `medianResponseSeconds` integer
    - `repliedCount` integer — Distinguishes 'instant replies' from 'no replies at all' so a zero medianResponseSeconds with repliedCount=0 renders as '—' instead of '0s'

## 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/versions/51932b099b2f/schema)