Sign inGet Started

bird email inbox-insights seed-tests list

Usage

Code example
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

Code example
bird email inbox-insights seed-tests list --sending-domain mail.acme.com

Options

NameDescription
--fromFirst 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-schemaPrint the fields this command returns, then exit
--sending-domainThe 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)
--toLast UTC day of the period, inclusive, in YYYY-MM-DD. Defaults to today.
NameDescription
bird email inbox-insights seed-tests createRegister a seed test and get its addresses

Continue with the documentation, guides and examples for this topic.