Mail: Logs
List access logs
Retrieve paginated access logs for the domain attached to the given mail order. Supports filtering by account, date range, protocol, status, and deletion flag. Results are sorted by timestamp descending.
get/api/mail/v1/orders/{orderId}/logs/access
Path parameters
orderIdstring required
Example:OR1a2b3c4d5e6f7g
Order resource ID
Query parameters
accountstring email nullable
Example:user@example.com
Filter log entries by a specific email account
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)
status'Successful' | 'Failed' nullable
Example:Successful
Filter log entries by status
protocol'imap' | 'pop3' | 'smtp' nullable
Example:imap
Filter access log entries by protocol
has_deletionsboolean nullable
Filter access log entries by whether the session had deletions
pageinteger
Example:1
Page number
per_pageinteger
Example:25
Number of items per page
Response
Success response
Example response
{
"data": [
{
"account": "user@example.com",
"domain": "example.com",
"session": "nVpwr1XahpcqAkeAAAQAAJjSnW8aYxyM",
"protocol": "imap",
"remote_ip": "192.168.0.1",
"login_time": "2026-03-16T13:13:54Z",
"in": 421,
"out": 9381,
"logout_time": "2026-03-16T13:13:55Z",
"timestamp": "2026-03-16T13:13:55Z",
"app_name": "com.google.android.gm",
"result": "ok",
"status": "Access"
}
],
"meta": {
"current_page": 1,
"per_page": 15,
"total": 100
}
}