# `bird whatsapp stats by-template`

## Usage

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

## Description

Outbound WhatsApp counts grouped by template slug, ranked by accepted volume. Rows sum to less than the period's accepted total: a free-form send resolves no template, and some volume cannot be attributed to one at all, so take the denominator from `bird whatsapp stats summary`. Rows are the whole workspace's: the breakdown takes no dimension filter; to see one template over time, filter `bird whatsapp stats daily` by `template` instead. Cap the rows with `limit` (default 50, max 200).

## Examples

```bash
bird whatsapp stats by-template
```

## 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 template rows to return, ranked by accepted volume descending.                                                                                                                                                                                                                                                          |
| `--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-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-category`](/docs/cli/reference/whatsapp-stats-by-template-category) | Get outbound WhatsApp statistics by template 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            |