# `bird email stats inbound summary`

## Usage

```bash
bird email stats inbound summary [flags]
```

## Description

Aggregate received-email total for one period, as a single row. The `from` and `to` values are both `YYYY-MM-DD` days or both RFC 3339 instants (hour grain). Filter with `tag` on an `inbound_address_id` or a `mailbox_id` to count one address or mailbox. For a per-day or per-hour series use `bird email stats inbound daily` or `bird email stats inbound hourly`; for what the workspace sent use `bird email stats summary`.

## Examples

```bash
bird email stats inbound summary
```

## Options

| Name                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--from`            | Inclusive start of the window: a calendar day (YYYY-MM-DD) or an RFC 3339 instant (rounded down to the hour). Interpreted in timezone, or in UTC when timezone is omitted. A numeric UTC offset (for example +05:45) is rejected when timezone is set; use a calendar day or a Z (UTC) instant. Must use the same form as to. Defaults to 30 days before to for day windows, or 168 hours (7 days) before to for hour windows, when omitted.                                                            |
| `--response-schema` | Print the fields this command returns, then exit                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `--tag`             | Restrict the count to a single tag. Use name to match any value of a tag, or name:value for a specific pair (for example mailbox\_id:mbx\_2f9k… or inbound\_address\_id:ina\_8c3d…).                                                                                                                                                                                                                                                                                                                    |
| `--timezone`        | IANA timezone identifier used to group statistics, for example Asia/Kathmandu. The default is UTC. Day and hour boundaries, including the default window when from and to are omitted, follow this timezone. When this parameter is set, pass from and to as calendar days or Z instants instead of timestamps with explicit UTC offsets.                                                                                                                                                               |
| `--to`              | Inclusive end of the window: a calendar day (YYYY-MM-DD) or an RFC 3339 instant (rounded down to the hour). Interpreted in timezone, or in UTC when timezone is omitted. A numeric UTC offset is rejected when timezone is set; use a calendar day or a Z (UTC) instant. Must use the same form as from. Defaults to today for day windows, or the current hour for hour windows, in that timezone, when omitted. Day windows may not exceed 365 days; hour windows may not exceed 720 hours (30 days). |

## Related

| Name                                                                                | Description                          |
| ----------------------------------------------------------------------------------- | ------------------------------------ |
| [`bird email stats inbound daily`](/docs/cli/reference/email-stats-inbound-daily)   | Get daily received-email statistics  |
| [`bird email stats inbound hourly`](/docs/cli/reference/email-stats-inbound-hourly) | Get hourly received-email statistics |