bird email seeding runs list
Usage
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
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 | Cancel an automatic seeding run |
bird email seeding runs get | Get an automatic seeding run |
Related resources
Continue with the documentation, guides and examples for this topic.