# `bird whatsapp stats daily`

## Usage

```bash
bird whatsapp stats daily [flags]
```

## Description

Outbound WhatsApp lifecycle counts, one row per calendar day of the window, gap-filled so a silent day is a zero row rather than a missing one. Every event a message produces counts against the day that message was accepted, so a row is a funnel over that day's sends and recent rows under-report while callbacks arrive. Each row carries its own latency percentiles, but delivery, failure and read rates are whole-window figures: read those from `bird whatsapp stats summary`. Accepts the same single-dimension restriction: `template`, `category`, `phone_number` or `tag`. Days are calendar days in `timezone`, or UTC when it is omitted. Max window 365 days; `from` and `to` default to the trailing 30 days.

## Examples

```bash
bird whatsapp stats daily
```

## Options

| Name                | Description                                                                                                                                                                                                                                                                                                                                                   |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--category`        | Restrict the statistics to a single template category. Mutually exclusive with the other dimension filters (template, phone\_number, tag); only one may be set per request. Matches the category key on a row of the per-category breakdown. Known values: authentication, utility, marketing (others may exist).                                             |
| `--from`            | Start date (inclusive), YYYY-MM-DD. Interpreted as a calendar day in timezone (a UTC day when timezone is omitted). The window may not exceed 365 days. Defaults to 30 days before to when omitted.                                                                                                                                                           |
| `--phone-number`    | Restrict the statistics to a single business sender phone number, in E.164 form. Mutually exclusive with the other dimension filters (template, category, tag); only one may be set per request. Matches the phone\_number key on a row of the per-phone-number breakdown.                                                                                    |
| `--response-schema` | Print the fields this command returns, then exit                                                                                                                                                                                                                                                                                                              |
| `--tag`             | Restrict the statistics to a single tag. Use name to match any value of a tag, or name:value for a specific pair (for example campaign:spring\_launch). Mutually exclusive with the other dimension filters (template, category, phone\_number); only one may be set per request. A row of the per-tag breakdown carries the same pair in its single tag key. |
| `--template`        | Restrict the statistics to a single template, by slug. Mutually exclusive with the other dimension filters (category, phone\_number, tag); only one may be set per request. Matches the template key on a row of the per-template breakdown.                                                                                                                  |
| `--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`              | End date (inclusive), YYYY-MM-DD. Interpreted as a calendar day in timezone (a UTC day when timezone is omitted). The window may not exceed 365 days. Defaults to today in that timezone when omitted.                                                                                                                                                        |

## Related

| Name                                                                                                  | Description                                           |
| ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| [`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 template category |
| [`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            |