v51

OpenAPI 3.0.0raw.githubusercontent.com2026-08-01267339950.6 KB
Mail: Logs

List mailbox action logs

Retrieve paginated mailbox action logs (message and mailbox events) for a mailbox in the given mail order. The mailbox email must belong to the order's domain. Supports date range and event type filters. Results are sorted by timestamp descending.

get/api/mail/v1/orders/{orderId}/logs/mailbox-actions

Path parameters

orderIdstring required
Example:OR1a2b3c4d5e6f7g

Order resource ID

Query parameters

emailstring email required
Example:user@example.com

Mailbox email address. Must belong to the order's domain.

datestring date nullable
Example:2026-03-16

Exact date filter (YYYY-MM-DD). Takes precedence over from_date/to_date when both are given.

from_datestring date-time nullable
Example:2026-03-01T00:00:00Z

Date range start (RFC 3339)

to_datestring date-time nullable
Example:2026-03-31T23:59:59Z

Date range end (RFC 3339)

event'MessageNew' | 'MessageRead' | 'MessageAppend' | 'MessageExpunge' | 'MailboxCreate' | 'MailboxDelete' | 'MailboxRename' nullable
Example:MessageNew

Filter mailbox action log entries by event type

pageinteger
Example:1

Page number

per_pageinteger
Example:25

Number of items per page

Response

Success response

Example response

{
  "data": [
    {
      "folder": "INBOX.Sent",
      "time": 1773906125,
      "event": "MessageNew",
      "mailbox": "user@example.com",
      "hostname": "de-fra-mailstorage71.hostinger.io",
      "timestamp": "2026-03-16T13:13:55Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 100
  }
}