Xurel Docs

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
}