# `bird email health`

## Usage

```bash
bird email health [flags]
```

## Description

Deliverability verdict for one window: an overall `healthy`, `watching`, or `throttled` status, plus signals for delivery, opens, bounces, and complaints. Each signal carries its rate and verdict. Delivery, bounce, and complaint signals include the thresholds that set their verdicts; open rate has no risk thresholds. Reports risk only and never pauses sending. Window defaults to the 7 days before today (UTC), maximum 365 days. For the counts and rates behind the verdict use `bird email stats summary`.

## Examples

```bash
bird email health
```

## Options

| Name                | Description                                                                                                                                                                                            |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--from`            | Start date (inclusive) in YYYY-MM-DD, UTC. Defaults to 7 days before to when omitted.                                                                                                                  |
| `--response-schema` | Print the fields this command returns, then exit                                                                                                                                                       |
| `--to`              | End date (inclusive) in YYYY-MM-DD, UTC. Defaults to today (UTC) when omitted. Window may not exceed 365 days. Day boundaries are always UTC; unlike the statistics reads, this one takes no timezone. |

## Related

| Name                                                            | Description                                |
| --------------------------------------------------------------- | ------------------------------------------ |
| [`bird email cancel`](/docs/cli/reference/email-cancel)         | Cancel a scheduled message                 |
| [`bird email content`](/docs/cli/reference/email-content)       | Get stored message content                 |
| [`bird email get`](/docs/cli/reference/email-get)               | Get a message                              |
| [`bird email list`](/docs/cli/reference/email-list)             | List messages                              |
| [`bird email recipients`](/docs/cli/reference/email-recipients) | List recipients of a message               |
| [`bird email send`](/docs/cli/reference/email-send)             | Send an email message                      |
| [`bird email send-batch`](/docs/cli/reference/email-send-batch) | Send a batch of email messages in one call |

## 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)