List Emails
Lists the emails of the workspace, newest first. Needs a Full key. A key limited to one domain lists only the emails sent from that domain.
Lists are paged with cursors. Read next_cursor and send it as after for the next page. A page has 50 items unless you set per_page, up to 100.
{ "data": [ { "id": "eml_06d2mfk8r4tq9xv2bnc7s", "from": "Acme <hello@acme.dev>", "to": [ "riti@example.com" ], "cc": [], "bcc": [], "subject": "Your receipt from Acme", "tags": [ { "name": "category", "value": "receipt" } ], "status": "delivered", "source": "api", "scheduled_at": null, "sent_at": "2026-10-15T14:02:34.000Z", "created_at": "2026-10-15T14:02:33.000Z" } ], "prev_cursor": null, "next_cursor": "eml_06d2mfk8r4tq9xv2bnc7s" }
Returns a page of emails.
Query Parameters
An email id, a recipient address, or text to find in the recipient or the subject.
One status or a comma-separated list: scheduled, queued, sending, sent, soft_bounced, delivered, opened, clicked, bounced, rejected, failed, canceled or complained.
is keeps emails with these statuses. not leaves them out. Defaults to is.
Where the email came from: api, smtp, dashboard, mcp, campaign or automation.
An ISO 8601 date. Keeps emails sent after it.
An ISO 8601 date. Keeps emails sent before it.
sent or to. Defaults to sent.
asc or desc. Defaults to desc.
How many items to return, from 1 to 100. Defaults to 50.
A next_cursor from the last page. Returns the items after it.
A prev_cursor from the last page. Returns the items before it. When you send both, before wins.
Response
The emails on this page.
Send it as before to get the page before. null on the first page.
Send it as after to get the next page. null on the last page.