API Reference

Emails

Emails are received newsletters stored under an email address. They're automatically created when a newsletter arrives and can be read via the RSS feed or the API.

List emails

GET /api/v1/email_addresses/:email_address_id/emails

Returns emails for a specific address, newest first. Paginated with keyset cursors.

Request


$ curl https://serssly.com/api/v1/email_addresses/1/emails \
    -H "Authorization: Token $SERSSLY_API_KEY"

Response 200


{
  "emails": [
    {
      "id": 42,
      "sender": "molly@example.com",
      "to": "wKx9vBp7@serssly.com",
      "cc": null,
      "subject": "Citation Needed #142",
      "body_text": "Plain text version...",
      "body_html": "<html>HTML with inlined CSS...</html>",
      "received_at": "2026-04-03T12:00:00Z"
    }
  ],
  "pagination": { "limit": 20, "next_url": null, "previous_url": null }
}

Delete an email

DELETE /api/v1/emails/:id

Deletes a single email. Frees storage. Returns 204 No Content.

Request


$ curl -X DELETE https://serssly.com/api/v1/emails/42 \
    -H "Authorization: Token $SERSSLY_API_KEY"