List emails across projects
Search the email log of every project, or one project by slug.
/v1/admin/emailsAdmin keyThe admin version of List emails. It takes the same filters and returns the same shape, but covers every project unless you pass project. Newest first. Each email includes its recipients but not its event timeline (events is []); fetch one email with GET /v1/admin/emails/:id for the timeline.
Query parameters
Only emails from the project with this slug.
Page size, 1 to 100.
The nextCursor from the previous page.
One email status: queued, scheduled, sending, sent, delivered, deferred, bounced, complained, rejected, failed, test or canceled.
Matches any recipient (to, cc or bcc). A full address matches exactly; text without @ matches part of an address, for example example.com.
The sender address, exact match (not the display name).
Text the subject contains.
A tag as key:value, for example kind:welcome.
Only emails created at or after this ISO 8601 date-time (with offset).
Only emails created before this ISO 8601 date-time (with offset).
Response
The emails, with the fields described in Retrieve an email.
Pass it as cursor for the next page. null on the last page. See Pagination.
Errors
| Status | Code | When |
|---|---|---|
| 400 | invalid_query | A filter is malformed, for example tag without a colon or limit over 100. |
| 404 | project_not_found | project is set and no project has that slug. |