Skip to content

Query email events

Request

Query email events with advanced filtering and human engagement detection.

This endpoint provides:

  • Real human engagement detection (is_human_engagement)
  • Bot/scanner filtering (scanner_detection)
  • Device and browser analytics (device_info)
  • Complete event timeline with stats

Data Retention: Events are retained based on your plan's data retention policy:

  • Free: 3 days
  • Starter: 7 days
  • Growth: 30 days
  • Professional: 90 days
  • Enterprise: 365 days

Tip: Upgrade to a higher plan for longer retention and access to historical event data.

Security
ApiKeyAuth
Query
email_idstring, (uuid)

Filter by specific email ID

typestring

Filter by event type:

  • bounced - Permanent failure (hard bounce)
  • failed - Temporary failure exhausted retries
  • deferred - Currently retrying
Enum:"queued""sent""delivered""bounced""failed""deferred""complained""opened""clicked""unsubscribed"
recipientstring, (email)

Filter by recipient email (partial match)

fromstring, (email)

Filter by sender email (partial match)

from_timestampstring, (date-time)

Filter events from this timestamp

to_timestampstring, (date-time)

Filter events until this timestamp

pageinteger, >= 1
Default:1
limitinteger, [ 1 .. 100 ]
Default:50
curl -i -X GET \
  'https://api.mailerlogic.net/api/v1/events?email_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&type=queued&recipient=user%40example.com&from=user%40example.com&from_timestamp=2019-08-24T14%3A15%3A22Z&to_timestamp=2019-08-24T14%3A15%3A22Z&page=1&limit=50' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Events retrieved successfully

Bodyapplication/json
eventsArray of objects(EmailEvent)
paginationobject(Pagination)
Response
{
  "events": [
    { … }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 50,
    "pages": 1
  }
}