Search Account Email Logs

Search the account's email logs across all domains using a flexible filter object.

POSThttps://api.maileroo.com/v1/logs/search

Search the account's email logs across all domains using a flexible filter object. Results are paginated.

Scope: user_logs.read

Request Body

filtersobjectoptional

The filter object to narrow down results. See the filter schema below.

pageintegeroptional

Page number. Defaults to 1.

Filter object

Field	Type	Description
`message_id`	string	Match a specific message ID (angle brackets added automatically).
`reference_id`	string	Match a reference ID.
`application_id`	integer	Filter by application (`0` = unset).
`subject`	string	Match subject.
`sender`	string	Match sender address.
`recipient`	string	Match recipient address.
`tags`	array	List of `{ "name", "value" }` tag filters.
`tags_operator`	string	`AND` (default) or `OR`.
`log_type`	string	`Delivered`, `Deferred`, `Suppressed`, `Bounced`, `Complained`, or `""`.
`sort_dir`	integer	`-1` newest first (default), `1` oldest first.
`datetime_from`	integer	Unix timestamp (`0` = unset).
`datetime_to`	integer	Unix timestamp (`0` = unset).

Empty strings and 0 values are ignored.

Sample Request

Request

POST https://api.maileroo.com/v1/logs/search
Content-Type: application/json

{
  "filters": {
    "log_type": "Delivered",
    "recipient": "[email protected]",
    "sort_dir": -1
  },
  "page": 1
}

Event log entries. Each entry includes message_id, reference_id, instance_id, ip_address, application_id, subject, sender, recipients (array), tags (array of {name,value}), events (array of { event_type, timestamp, message, data }), and datetime.

pageintegeroptional

Current page.

has_morebooleanoptional

Whether more pages are available.

Sample Response

200 OK

{
  "data": {
    "items": [
      {
        "message_id": "[email protected]",
        "reference_id": "ref-9",
        "subject": "Welcome",
        "sender": "[email protected]",
        "recipients": ["[email protected]"],
        "tags": [
          {
            "name": "campaign",
            "value": "welcome"
          }
        ],
        "events": [
          {
            "event_type": "delivered",
            "timestamp": 1751000000,
            "message": "250 OK",
            "data": {}
          }
        ],
        "datetime": "2026-06-28T10:00:00Z"
      }
    ],
    "page": 1,
    "has_more": false
  }
}

PreviousGet Timeline Next Get Email

Request Body

filtersobjectoptional

The filter object to narrow down results. See the filter schema below.

pageintegeroptional

Page number. Defaults to 1.

Filter object

Field	Type	Description
`message_id`	string	Match a specific message ID (angle brackets added automatically).
`reference_id`	string	Match a reference ID.
`application_id`	integer	Filter by application (`0` = unset).
`subject`	string	Match subject.
`sender`	string	Match sender address.
`recipient`	string	Match recipient address.
`tags`	array	List of `{ "name", "value" }` tag filters.
`tags_operator`	string	`AND` (default) or `OR`.
`log_type`	string	`Delivered`, `Deferred`, `Suppressed`, `Bounced`, `Complained`, or `""`.
`sort_dir`	integer	`-1` newest first (default), `1` oldest first.
`datetime_from`	integer	Unix timestamp (`0` = unset).
`datetime_to`	integer	Unix timestamp (`0` = unset).

Empty strings and 0 values are ignored.

Response

itemsarrayoptional

pageintegeroptional

Current page.

has_morebooleanoptional

Whether more pages are available.

Sample Response

200 OK

{
  "data": {
    "items": [
      {
        "message_id": "[email protected]",
        "reference_id": "ref-9",
        "subject": "Welcome",
        "sender": "[email protected]",
        "recipients": ["[email protected]"],
        "tags": [
          {
            "name": "campaign",
            "value": "welcome"
          }
        ],
        "events": [
          {
            "event_type": "delivered",
            "timestamp": 1751000000,
            "message": "250 OK",
            "data": {}
          }
        ],
        "datetime": "2026-06-28T10:00:00Z"
      }
    ],
    "page": 1,
    "has_more": false
  }
}