Email

List the emails of an app (from the app)

For an app's own server code only: await env.HYPAMOON.listEmails({ to, status, since, limit, cursor }) does this call without an Authorization header; Hypamoon adds the app's key, and any other key gets 403. Only the emails this app sent with sendEmail or sendEmailBatch, newest first, never those of another app or of the API. Each with its status, reason, status per recipient and timeline, as GET /emails/{id}.

get/app-emails

Request

  • Base URL: https://api.hypamoon.com/api/v1
  • URL: https://api.hypamoon.com/api/v1/app-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: data:read)

Query parameters

limitinteger

Emails per page, 1 to 100.

cursorstring

The next_cursor of the previous page.

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 app's emails.

next_cursorstring nullable required

Changes

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