Test Emails

When you send with a test-mode API key, Sendry does not deliver the message. Instead it stores a copy in test_emails, scoped to your organization, so you can inspect exactly what would have been sent. These endpoints list those captures and fetch the full stored message, including the HTML and text bodies.

---

List test emails

GET /v1/test-emails

Requires read_only scope. Cursor-paginated by created_at, newest first.

Query parameters

Parameter	Type	Default	Description
limit	number	50	Results per page (1-100).
cursor	string		next_cursor from a previous response.

Response

{
  "data": [
    {
      "id": "tmail_abc123",
      "from": "noreply@example.com",
      "to": ["stanley@example.com"],
      "subject": "Welcome aboard",
      "message_type": "transactional",
      "created_at": "2026-05-30T14:00:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

---

Get test email

GET /v1/test-emails/:id

Requires read_only scope. Returns the full stored message, including cc, html, and text. Returns 404 with code not_found if the test email does not belong to your organization.

Response

{
  "id": "tmail_abc123",
  "from": "noreply@example.com",
  "to": ["stanley@example.com"],
  "cc": ["ops@example.com"],
  "subject": "Welcome aboard",
  "html": "<p>Thanks for signing up.</p>",
  "text": "Thanks for signing up.",
  "message_type": "transactional",
  "created_at": "2026-05-30T14:00:00Z"
}