---
title: "GET /stats/by-period"
method: GET
path: "/stats/by-period"
---

# GET /stats/by-period

`GET /stats/by-period`

Get email statistics grouped by time period. Returns counts of emails by status (all, sent, read, unread, archived, unarchived) for each period.

## Query parameters

- `period` 'day' | 'week' | 'month' | 'year'
- `fromDate` number, nullable
- `toDate` number, nullable

## Response `200`

Successful response

- object
  - `result` object[], required
    - `startOfPeriod` string, required
    - `All` number, required
    - `Sent` number, required
    - `Read` number, required
    - `Unread` number, required
    - `Unarchived` number, required
    - `Archived` number, required
  - `allCount` number, required
  - `inboxCount` number, required
  - `readCount` number, required
  - `sentCount` number, required

---

[API](https://skmtc.dev/getinboxzero/apis/inbox-zero-api.md) · [All operations](https://skmtc.dev/getinboxzero/apis/inbox-zero-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getinboxzero/inbox-zero-api/revisions/e0fa35a97a28/schema)