Emails

List sent emails

The send log across all sources, newest first, cursor-paginated. Bodies are omitted — fetch one email for the full content.

get/v1/emails

Request

  • Base URL: https://api.volanea.com
  • URL: https://api.volanea.com/v1/emails
  • Auth: HTTP bearer

Query parameters

cursorstring

Pagination cursor — an OPAQUE token. Take the nextCursor from the previous page and send it back unchanged. Do not parse it, do not coerce it to a number, and do not construct one: the format is <unixMs>.<objectId> today and may change. A cursor that cannot be parsed is rejected with 422 validation_error rather than silently restarting at page one.

limitinteger

Page size (1–200, default 50).

status'queued' | 'sending' | 'sent' | 'delivered' | 'opened' | 'clicked' | 'bounced' | 'complained' | 'failed' | 'received' | 'cancelled' | 'scheduled'

scheduled is a VIEW, not a stored status: it selects rows stored queued whose scheduledFor is still in the future. This is the only way to list pending scheduled sends — filtering on queued also returns messages already handed to the provider and awaiting a callback, which is the opposite of "still pending". POST /v1/send has always returned status: "scheduled", so until this was accepted here the API handed callers a value it then refused to take back. The rows that come back still read "status": "queued" — the stored value — with the schedule in scheduledFor.

source'transactional' | 'campaign' | 'workflow' | 'inbound'
tostring email

Filter by recipient address.

Response

A page of send-log rows.

nextCursorstring nullable required

Opaque token. Pass back as cursor verbatim to fetch the next page; null when there are no more rows.

Changes

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