Logs

List email events

The event log behind the dashboard Logs page: every lifecycle event of every sent email, newest first, with keyset pagination (after walks older, before walks newer, exclusive). Filter by event type, time window, recipient, domain, tag or email. Received mail is not in this log; use GET /v1/emails/receiving. Requires the logs:read scope.

get/v1/logs

Request

  • Base URL: https://smtpfa.st/api
  • URL: https://smtpfa.st/api/v1/logs
  • Auth: HTTP bearer

Query parameters

limitinteger
afterstring

Return events older than this event id

beforestring

Return events newer than this event id

typestring

One event type or a comma-separated list: queued, scheduled, sending, retrying, sent, delivered, delivery_delayed, bounced, complained, opened, clicked, unsubscribed, suppressed, failed

sincestring date-time

Only events at or after this time

untilstring date-time

Only events at or before this time

recipientstring

Exact To address

domainstring

Sending domain name

domain_idstring

Sending domain id (alternative to domain)

tagstring

Tag as name:value, matched exactly

email_idstring

Events of one email

Response

Email events

objectstring
has_moreboolean

Example response

{
  "object": "list",
  "data": [
    {
      "object": "event",
      "type": "delivered"
    }
  ]
}

Changes

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