---
title: "bird email seeding runs list"
description: "List automatic seeding runs"
canonical: "https://bird.com/docs/cli/reference/email-seeding-runs-list"
---

# `bird email seeding runs list`

## Usage

```bash
bird email seeding runs list [flags]
```

## Description

Read retained sending progress. For a known run ID, use
`bird email seeding runs get` directly. Otherwise filter by the original email or broadcast and follow
cursors with the same filters. No settings read is required. An empty page establishes only that
this response has no retained matching record. Reads can lag, history can expire, or no run may
exist; absence cannot distinguish these causes or establish whether seeding ever started or
delivered. Do not resend based on absence. Provider acceptance, delivery,
and inbox placement are separate outcomes. Domain-level placement measurements are not run results.
trigger\_rotated can reflect disabling settings; re-enabling does not advance the cancellation
generation or resume fenced copies. The reason proves neither an address change nor that it
stayed unchanged. An unchanged integration configuration does not establish Bird's current trigger.

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

## Procedure

Step 2 of 3 of "Inspect Automatic Email Seeding activity". Previous: bird email seeding sources list. Next: bird email seeding runs get.

## Examples

```bash
bird email seeding runs list
bird email seeding runs list | jq -r '.data[].id'
bird email seeding runs list --limit 50 --starting-after <cursor>
```

## Options

#### Filters

| Name                    | Description                                                                                                                                                                     |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--created-after`       | Limits the response to resources created at or after this timestamp. Combine it with created\_before to select a time window. Use an RFC 3339 timestamp with a timezone offset. |
| `--created-before`      | Limits the response to resources created before this timestamp. Combine it with created\_after to select a time window. Use an RFC 3339 timestamp with a timezone offset.       |
| `--response-schema`     | Print the fields this command returns, then exit                                                                                                                                |
| `--sending-domain`      | Match the exact sending domain recorded during registration.                                                                                                                    |
| `--source-broadcast-id` | Match an original broadcast. Cannot be combined with source\_email\_id. If source\_kind is supplied, it must be broadcast; conflicting combinations return 422.                 |
| `--source-email-id`     | Match an original email. Cannot be combined with source\_broadcast\_id or source\_kind=broadcast; either combination returns 422.                                               |
| `--source-kind`         | Match the original source kind. Possible values: api, smtp, scheduled, broadcast.                                                                                               |
| `--state`               | Match the current derived execution state. Possible values: pending, registering, registration\_uncertain, ready, dispatching, dispatch\_complete, stopped, failed.             |

#### 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. |
| `--include-total`  | When true, the response includes a total field with the total number of items matching the request's filters across all pages.                                                                                                                                                                                                                          |
| `--limit <n>`      | Maximum number of items to return per page. Allowed range: 1 to 100.                                                                                                                                                                                                                                                                                    |
| `--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 by. Possible values: created\_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.                                                                                                                                                                                                          |

## Related

| Name                                                                              | Description                     |
| --------------------------------------------------------------------------------- | ------------------------------- |
| [`bird email seeding runs cancel`](/docs/cli/reference/email-seeding-runs-cancel) | Cancel an automatic seeding run |
| [`bird email seeding runs get`](/docs/cli/reference/email-seeding-runs-get)       | Get an automatic seeding run    |

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