# `bird email stats by-broadcast`

## Usage

```bash
bird email stats by-broadcast [flags]
```

## Description

Email delivery and engagement stats grouped by broadcast; only broadcast sends appear. Reflects roughly the last 30 days of activity; `include_trend` is not available here and returns 422.

## Examples

```bash
bird email stats by-broadcast
```

## Options

| Name                | Description                                                                                                                                                                                      |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--category`        | Not supported on breakdown endpoints; supplying it returns 422. To compare categories use GET /v1/email/stats/categories; the summary, daily, and hourly statistics accept category as a filter. |
| `--from`            | Start date (inclusive) in YYYY-MM-DD, UTC. Defaults to 30 days before to when omitted.                                                                                                           |
| `--include-trend`   | Requests a per-row trend series. Not available for the broadcast breakdown; supplying true returns 422.                                                                                          |
| `--limit <n>`       | Maximum number of broadcast rows to return, ranked by the sort field descending.                                                                                                                 |
| `--response-schema` | Print the fields this command returns, then exit                                                                                                                                                 |
| `--sort`            | Metric to rank rows by, applied descending. Any count or rate in the response may be used; rows whose rate is undefined (zero denominator) sort last. Defaults to processed.                     |
| `--to`              | End date (inclusive) in YYYY-MM-DD, UTC. Defaults to today (UTC) when omitted. Window may not exceed 365 days.                                                                                   |
| `--trend-grain`     | Bucket grain for the trend series. Has no effect on this breakdown, where include_trend is not available.                                                                                        |

## Related

| Name                                                                                                        | Description                      |
| ----------------------------------------------------------------------------------------------------------- | -------------------------------- |
| [`bird email stats by-bounce-code`](/docs/cli/reference/email-stats-by-bounce-code)                         | Bounces by SMTP error code       |
| [`bird email stats by-category`](/docs/cli/reference/email-stats-by-category)                               | Stats by category                |
| [`bird email stats by-client`](/docs/cli/reference/email-stats-by-client)                                   | Engagement by email client       |
| [`bird email stats by-complaint-type`](/docs/cli/reference/email-stats-by-complaint-type)                   | Complaints by type               |
| [`bird email stats by-location`](/docs/cli/reference/email-stats-by-location)                               | Engagement by location           |
| [`bird email stats by-mailbox-provider`](/docs/cli/reference/email-stats-by-mailbox-provider)               | Stats by mailbox provider        |
| [`bird email stats by-mailbox-provider-region`](/docs/cli/reference/email-stats-by-mailbox-provider-region) | Stats by mailbox provider region |
| [`bird email stats by-recipient-domain`](/docs/cli/reference/email-stats-by-recipient-domain)               | Stats by recipient domain        |
| [`bird email stats by-sending-domain`](/docs/cli/reference/email-stats-by-sending-domain)                   | Stats by sending domain          |
| [`bird email stats by-sending-ip`](/docs/cli/reference/email-stats-by-sending-ip)                           | Stats by sending IP              |
| [`bird email stats by-tag`](/docs/cli/reference/email-stats-by-tag)                                         | Stats by tag                     |
| [`bird email stats by-template`](/docs/cli/reference/email-stats-by-template)                               | Stats by template                |
| [`bird email stats daily`](/docs/cli/reference/email-stats-daily)                                           | Daily sending statistics         |
| [`bird email stats hourly`](/docs/cli/reference/email-stats-hourly)                                         | Hourly sending statistics        |
| [`bird email stats summary`](/docs/cli/reference/email-stats-summary)                                       | Aggregate stats summary          |