---
title: "Read how mail arrives"
description: "How mail arrives, as the Analytics page of the app shows it."
url: "https://openemail.uk/docs/api/analytics/mailbox"
area: "API"
category: "Mailbox"
---

# Read how mail arrives

How mail arrives, as the Analytics page of the app shows it.

`GET /analytics/mailbox`

## GET /analytics/mailbox

How mail arrives, as the Analytics page of the app shows it.

## Example

Needs `threads:read`. The window is the last 30 days unless `from` and `to` say otherwise, cut into days, or into hours or minutes with `grain`. Pass `offsetMinutes`, the reader’s minutes east of UTC, so a day breaks where theirs does.

**curl**

```
curl "$OE/analytics/mailbox?offsetMinutes=120" -H "$AUTH"
```

**Response**

```
{
  "object": "mailbox_insights",
  "from": "2026-09-02T09:00:00.000Z",
  "to": "2026-10-02T09:00:00.000Z",
  "grain": "day",
  "offsetMinutes": 120,
  "scanned": 486,
  "days": [
    { "day": "2026-09-30", "count": 21 },
    { "day": "2026-10-01", "count": 17 }
  ],
  "hours": [
    { "hour": 9, "count": 64 },
    { "hour": 14, "count": 51 }
  ],
  "addresses": [{ "address": "hello@acme.com", "count": 301 }],
  "senders": [
    {
      "email": "ada@lovelace.dev",
      "name": "Ada Lovelace",
      "count": 18,
      "lastAt": "2026-10-01T16:20:11.000Z"
    }
  ],
  "senderCount": 132,
  "waiting": [
    { "band": 1, "count": 6 },
    { "band": 3, "count": 2 },
    { "band": 7, "count": 1 }
  ],
  "unattributed": 0,
  "folders": [{ "label": "inbox", "count": 412, "unread": 9 }],
  "series": []
}
```

> `scanned` counts the conversations that arrived inside the window. `days` spreads them over the buckets and `hours` over the hours of the day, `addresses` counts them by the address they arrived at, and `senders` names the people who wrote most. `waiting` counts the conversations still waiting on a reply after 1, 3 and 7 days, and `folders` what each folder holds.

> A key or an app limited to particular addresses counts only the mail that arrived at them. `address` narrows everything to one address, and an address outside what the key reaches counts nothing rather than failing.

## Reference

- [`GET /analytics/mailbox`](https://openemail.uk/docs/api/reference/analytics#get-analytics-mailbox): full reference