Email

List sent emails

The project's emails, newest first, each with its status, a short reason when it bounced, was marked as spam, is delayed or was not sent, the status per recipient and a timeline. Plus the state of the Mail module: on or off, paused, the daily limit and what was sent in the last 24 hours. Filter on the app that sent them (app_id), a recipient (to), a status and a start time (since).

get/emails

Request

  • Base URL: https://api.hypamoon.com/api/v1
  • URL: https://api.hypamoon.com/api/v1/emails
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.hypamoon.com/oauth/authorize, token URL https://api.hypamoon.com/oauth/token, scopes: messages:read)

Query parameters

limitinteger

Emails per page, 1 to 100.

cursorstring

The next_cursor of the previous page.

app_idstring uuid

Only emails this app sent with env.HYPAMOON.sendEmail (an id from list_apps).

tostring

Only emails with this address in to, cc or bcc.

status'queued' | 'sent' | 'delivered' | 'bounced' | 'complained' | 'failed' | 'simulated'

Only emails with this status.

sincestring date-time

Only emails sent at or after this moment, like 2026-10-01 or 2026-10-15T09:00:00Z.

Response

The emails and the state of the module.

next_cursorstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.