Transactional Emails
GET
List Transactional Emails
GET /v1/emailsRetrieve a paginated list of transactional emails sent from your workspace.
Use Cases:
- Monitor transactional email delivery status
- Search for specific emails by recipient or subject
- Filter emails by status or date range
- Build email activity dashboards
- Debug delivery issues for specific recipients
Behavior:
- Returns emails in reverse chronological order (newest first)
- Uses cursor-based pagination for efficient retrieval
- Supports filtering by status, recipient, subject, and date range
- Maximum 100 emails per request
- Includes delivery tracking metadata (opens, clicks, bounces)
Required Scope: smtp:send
Filtering:
- status: Filter by delivery status (queued, sending, sent, delivered, bounced, complained, failed)
- to: Search by recipient email (case-insensitive partial match)
- subject: Search by subject line (case-insensitive partial match)
- from_date: Filter emails created on or after this date (ISO 8601)
- to_date: Filter emails created on or before this date (ISO 8601)
Response Includes:
- Email ID and sending ID
- Sender and recipient information
- Subject and delivery status
- Open and click counts
- Delivery lifecycle timestamps
Query parameters
limitintegerNumber of items to return (default: 20, max: 100)
afterstringCursor for pagination - ID of the last item from the previous page
beforestringCursor for reverse pagination - ID of the first item from the next page
statusstringFilter by delivery status (e.g., delivered, bounced, complained)
tostringFilter by recipient email address (case-insensitive partial match)
subjectstringFilter by subject line (case-insensitive partial match)
from_datestringFilter emails created on or after this date (ISO 8601 format)
to_datestringFilter emails created on or before this date (ISO 8601 format)
Response
200Successfully retrieved paginated list of transactional emails with delivery metadata
objectstringrequiredhasMorebooleanrequireddataobject[]required