---
title: "Get inbox source breakdown"
method: GET
path: "/v1/analytics/inbox/source-breakdown"
tags: ["Inbox Analytics"]
---

# Get inbox source breakdown

`GET /v1/analytics/inbox/source-breakdown`

Breakdown of inbox messages by their lineage source (the
`metadata.source` field set at ingest time: human / workflow /
sequence / broadcast / comment_automation / api / contact /
platform). Each source row also carries a per-platform sub-split.
Max date range is 365 days.

## Query parameters

- `fromDate` string, date, required
- `toDate` string, date
- `profileId` string
- `platform` string
- `accountId` string

## Response `200`

Source breakdown

- object
  - `success` boolean
  - `from` string, date
  - `to` string, date, nullable
  - `sources` object[]
    - `source` string
    - `received` integer
    - `sent` integer
    - `read` integer
    - `byPlatform` object[]
      - `platform` string
      - `received` integer
      - `sent` integer
      - `read` integer

## Other responses

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

## Changes

- **2026-09-25** `2c04683ce694` — 4 info
  - added the optional property `details/adAccountId` to the response with the `500` status
  - added the optional property `details/createdObjects` to the response with the `500` status
  - added the optional property `details/stage` to the response with the `500` status
  - added the optional property `details/unconfirmedWrite` to the response with the `500` status
- **2026-09-16** `3e6ddf2a99ea` — 1 info
  - added the optional property `details/budgetScope` to the response with the `500` status
- **2026-09-15** `0dba7d004d75` — 2 info
  - added the optional property `details/quotaExhausted` to the response with the `500` status
  - added the optional property `details/quotaScope` to the response with the `500` status

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/analytics/inbox/source-breakdown/get.md)

---

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