List sent emails
listSentEmailsRead-onlyIdempotent
List outbound emails sent by this org, with cursor pagination and filters. Each row is id, thread_id, created_at, status, from, to, subject and a snippet, plus the error, SMTP response or gate denial when the send did not deliver. Use getSentEmail to read the body of one. Useful for auditing delivery status, finding bounced sends, or checking gate-denied attempts.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| full | No | Set true for the record as stored. By default the result is a compact view for reading, which leaves out idempotency and content hashes, message ids, signing details and, for a delivered row, the SMTP response. | |
| limit | No | Maximum number of sent emails to return (1 to 100, default 50). | |
| cursor | No | Pagination cursor from a previous response's `meta.cursor` field. | |
| status | No | Filter to rows in this status. Use "scheduled" to find pending scheduled sends and "canceled" for ones already canceled. | |
| date_to | No | Inclusive upper bound on created_at. An ISO 8601 date-time with Z or a UTC offset ("2026-10-01T09:00:00Z", "2026-10-01T09:00:00-04:00"), or a calendar date ("2026-10-01"), which runs to the end of that day, UTC. A time with no offset is read as UTC. | |
| date_from | No | Inclusive lower bound on created_at. An ISO 8601 date-time with Z or a UTC offset ("2026-10-01T09:00:00Z", "2026-10-01T09:00:00-04:00"), or a calendar date ("2026-10-01"), which starts at 00:00 UTC. A time with no offset is read as UTC. | |
| request_id | No | Filter to the row matching a specific server-issued request_id from a /send-mail response. | |
| idempotency_key | No | Filter to rows with the given client idempotency key. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| tool | Yes | ||
| status | Yes | ||
| statusText | No |