List emails
List emails for the tenant with optional filters. Cursor pagination applies.
Endpoint
GET
/v1/emails Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
| limit | integer | Optional | Default 20, max 100. |
| startingAfter | string | Optional | Cursor for next page. |
| status | string | Optional | Filter: queued, sent, delivered, bounced, complained, canceled. |
| from | string | Optional | Filter by from address / domain. |
| to | string | Optional | Filter by recipient. |
Response
200
{
"data": [
{
"id": "em_a1b2c3d4",
"from": "hello@yourdomain.com",
"to": ["user@example.com"],
"subject": "Hello",
"status": "delivered",
"createdAt": "2026-07-12T10:00:00Z"
}
],
"hasMore": false,
"nextCursor": null
}