# `bird email competitive watchlist brands campaigns list`

## Usage

```bash
bird email competitive watchlist brands campaigns list <watchlist-brand-id> [flags]
```

## Description

Takes a watchlist\_brand\_id from `bird email competitive watchlist get`. Returns a
cursor page, default 25 rows and maximum 100. Cursors retain the brand, range
and ordering: next\_cursor advances with starting\_after; prev\_cursor or
refresh\_cursor reads preceding rows with ending\_before. captured and
promo\_rate describe a sample independently of this page. next\_cursor controls
continuation; truncated can also describe the sample.

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

Returns a paginated JSON envelope; narrow with the filters below and page with --limit and --starting-after.

## Examples

```bash
bird email competitive watchlist brands campaigns list <watchlist-brand-id>
bird email competitive watchlist brands campaigns list <watchlist-brand-id> | jq -r '.data[].id'
bird email competitive watchlist brands campaigns list <watchlist-brand-id> --limit 50 --starting-after <cursor>
```

## Options

#### Pagination

| Name               | Description                                                                                                                                                                                                                                                                                                                                             |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--ending-before`  | Cursor from the prev\_cursor or refresh\_cursor field of a previous list response. Returns items immediately before the cursor position in the current sort order. prev\_cursor returns the preceding page. refresh\_cursor anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since. |
| `--limit <n>`      | Maximum number of items to return per page.                                                                                                                                                                                                                                                                                                             |
| `--order`          | Sort direction. Defaults to desc, which sorts from newest to oldest or largest to smallest, depending on the selected sort field. Possible values: asc, desc.                                                                                                                                                                                           |
| `--sort`           | Field to sort campaigns by. Possible values: sent\_at.                                                                                                                                                                                                                                                                                                  |
| `--starting-after` | Cursor from the next\_cursor field of a previous list response. Returns items immediately after the cursor position in the current sort order.                                                                                                                                                                                                          |

#### Filters

| Name                | Description                                                                                                                                                                                                                    |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--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

| Name                                                                                                                            | Description                           |
| ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| [`bird email competitive watchlist brands campaigns get`](/docs/cli/reference/email-competitive-watchlist-brands-campaigns-get) | Get one campaign a watched brand sent |

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