---
title: "bird email inbox-insights seed-tests list"
description: "Get seed tests for a sending domain"
canonical: "https://bird.com/docs/cli/reference/email-inbox-insights-seed-tests-list"
---

# `bird email inbox-insights seed-tests list`

## Usage

```bash
bird email inbox-insights seed-tests list [flags]
```

## Description

Read seed-test history for an owned sending domain and the organization-wide
allowance. Results are capped at 100; narrow the date window if tests.truncated
is true. Only the newest test has full detail. registration\_id cannot locate a
history row, and absent history does not prove a registration failed.
Scoped API keys, OAuth and service accounts require organization preview access.

## Procedure

Step 4 of 4 of "Measure a send with seed mailboxes". Previous: bird email inbox-insights seed-tests create.

## Examples

```bash
bird email inbox-insights seed-tests list --sending-domain mail.acme.com
```

## Options

| Name                | Description                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--from`            | First UTC day of the period, inclusive, in YYYY-MM-DD: the same window convention as the email statistics endpoints. Defaults to 90 days before to, which is the span the history view shows. It may be at most 90 days before to, which is also the default, so a request naming neither date is already at the limit. Asking for more answers 422. To reach older tests, request an earlier period. |
| `--response-schema` | Print the fields this command returns, then exit                                                                                                                                                                                                                                                                                                                                                      |
| `--sending-domain`  | The sending domain to report on: one of the workspace's verified sending domains, exactly as it appears there. A domain that is not verified in this workspace answers not-found. (required)                                                                                                                                                                                                          |
| `--to`              | Last UTC day of the period, inclusive, in YYYY-MM-DD. Defaults to today.                                                                                                                                                                                                                                                                                                                              |

## Related

| Name                                                                                                        | Description                                |
| ----------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| [`bird email inbox-insights seed-tests create`](/docs/cli/reference/email-inbox-insights-seed-tests-create) | Register a seed test and get its addresses |

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