# `bird email competitive volume-series`

## Usage

```bash
bird email competitive volume-series [flags]
```

## Description

Accepts up to 20 distinct watchlist entry IDs from
`bird email competitive watchlist get`. Omitting brand\_ids requests the workspace's
own line. Competitor lines retain the requested order after the workspace
line, when present. Each line's source distinguishes estimated panel volume
from the workspace's accepted sends. Returns daily series without pagination.

API-key calls require Insights preview access for your organization.

## Examples

```bash
bird email competitive volume-series
```

## Options

| Name                   | Description                                                                                                                                                                                                                    |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--brand-ids <value>…` | Which watched brands to plot, in the order you want the lines. Omit to get only your own line. An id your workspace does not watch is rejected rather than skipped, so a chart cannot quietly lose a line.                     |
| `--range <n>`          | How many days back the response covers, counting from now. One of three fixed trend windows rather than an open date range, matching how a competitive-intelligence chart is read. Defaults to 30. Possible values: 7, 30, 90. |
| `--response-schema`    | Print the fields this command returns, then exit                                                                                                                                                                               |

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