Account Statistics

MailReach exposes per-account messaging statistics through the conversation_message_logs endpoints. They return daily-bucketed time series you can plot directly as charts: how many emails the account sent, how many it received, and how sent messages were distributed across inbox, categories, spam, and other folders.

Use these endpoints to:

Build your own deliverability dashboard on top of MailReach data.
Monitor sending volume to stay within safe thresholds.
Track inbox placement over time for a given account.
Correlate sending activity with reputation changes.

All three endpoints share the same response shape and query parameters. Once you've integrated one, the others work the same way.

Common parameters

Parameter	In	Description
`account_id`	path	The MailReach account ID. Returned when you connect an account.
`past_days`	query	Size of the time window, in days. Range `0`–`180`. Defaults to `14`.
`provider`	query	Optional filter: `gmail`, `outlook`, or `others`. Omit to include all providers.

Common response shape

Every endpoint returns the same structure, ready to feed into any chart library:

{
  "labels": ["Apr 10", "Apr 11", "Apr 12", "Today"],
  "data": [65, 74, 59, 26],
  "consolidated": true
}

Field	Description
`labels`	Day labels, one per bucket. The most recent bucket is labeled `"Today"`.
`data`	Message count per bucket, in the same order as `labels`.
`consolidated`	`true` when older buckets use consolidated historical data (typically anything older than 2 days).

1. Messages sent per day

Retrieve the total number of messages the account has sent, grouped by day:

GET https://api.mailreach.co/api/v1/conversation_message_logs/{account_id}/sent/graph?past_days=30
X-Api-Key: Bearer YOUR_API_KEY

See GET /v1/conversation_message_logs/{account_id}/sent/graph in the reference.

2. Messages received per day

Retrieve the total number of messages the account has received, grouped by day:

GET https://api.mailreach.co/api/v1/conversation_message_logs/{account_id}/received/graph?past_days=30
X-Api-Key: Bearer YOUR_API_KEY

Useful to detect drops in inbound volume or to correlate sending activity with reply rates.

See GET /v1/conversation_message_logs/{account_id}/received/graph in the reference.

3. Inbox placement of sent messages

Retrieve how many sent messages landed in a given folder, per day:

GET https://api.mailreach.co/api/v1/conversation_message_logs/{account_id}/sent/categories/graph/{cat}?past_days=30&provider=gmail
X-Api-Key: Bearer YOUR_API_KEY

The cat path parameter selects the folder:

Value	Description
`INBOX`	Messages delivered to the primary inbox
`CATEGORIES`	Messages filtered into Gmail tabs (Promotions, Updates, etc.)
`SPAM`	Messages that landed in spam
`OTHERS`	Everything else

To build a full placement breakdown, call the endpoint once per category and stack the four series on the same timeline.

See GET /v1/conversation_message_logs/{account_id}/sent/categories/graph/{cat} in the reference.

Filtering by provider

Pass provider=gmail, provider=outlook, or provider=others to restrict numbers to that provider family. Useful when an account exchanges mail with multiple provider types and you want to isolate, for example, only Gmail-to-Gmail placement.

Credits

These endpoints only read existing data and do not consume any credits.

Connect an Inbox

Webhooks & Alerts