---
title: "bird whatsapp stats by-broadcast"
description: "Get outbound WhatsApp statistics by broadcast"
canonical: "https://bird.com/docs/cli/reference/whatsapp-stats-by-broadcast"
---

# `bird whatsapp stats by-broadcast`

## Usage

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

## Description

Compare broadcasts by delivery: sent, delivered, read and failed counts with their rates, one row per broadcast, ranked by accepted volume. Rows count messages by send time, so a recent window under-reports deliveries still arriving. For one broadcast's recipients, use `bird whatsapp broadcasts list-recipients`.

## Examples

```bash
bird whatsapp stats by-broadcast
```

## Options

| Name                | Description                                                                                                                                                                                                                                                                                                                               |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--from`            | Inclusive start of the window, a calendar day (YYYY-MM-DD). Interpreted in timezone, or UTC when omitted. Must not be after to. Max window 365 days. Defaults to 30 days before to when omitted.                                                                                                                                          |
| `--limit <n>`       | Maximum number of broadcast rows to return, ranked by accepted volume descending. Allowed range: 1 to 200.                                                                                                                                                                                                                                |
| `--response-schema` | Print the fields this command returns, then exit                                                                                                                                                                                                                                                                                          |
| `--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). Interpreted in timezone, or UTC when omitted. Max window 365 days. Defaults to today in that timezone when omitted.                                                                                                                                                             |

## Related

| Name                                                                                                  | Description                                          |
| ----------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| [`bird whatsapp stats by-country`](/docs/cli/reference/whatsapp-stats-by-country)                     | Get outbound WhatsApp statistics by country          |
| [`bird whatsapp stats by-error-code`](/docs/cli/reference/whatsapp-stats-by-error-code)               | Get outbound WhatsApp statistics by error code       |
| [`bird whatsapp stats by-phone-number`](/docs/cli/reference/whatsapp-stats-by-phone-number)           | Get outbound WhatsApp statistics by phone number     |
| [`bird whatsapp stats by-tag`](/docs/cli/reference/whatsapp-stats-by-tag)                             | Get outbound WhatsApp statistics by tag              |
| [`bird whatsapp stats by-template`](/docs/cli/reference/whatsapp-stats-by-template)                   | Get outbound WhatsApp statistics by template         |
| [`bird whatsapp stats by-template-category`](/docs/cli/reference/whatsapp-stats-by-template-category) | Get outbound WhatsApp statistics by message category |
| [`bird whatsapp stats daily`](/docs/cli/reference/whatsapp-stats-daily)                               | Get daily outbound WhatsApp statistics               |
| [`bird whatsapp stats hourly`](/docs/cli/reference/whatsapp-stats-hourly)                             | Get hourly outbound WhatsApp statistics              |
| [`bird whatsapp stats summary`](/docs/cli/reference/whatsapp-stats-summary)                           | Get aggregate outbound WhatsApp statistics           |

## Related resources

- [Should I use a Bird SDK or call the API directly?](/explained/platform/should-i-use-an-sdk-or-call-the-api-directly) (answer)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=api-basics)