Mail: Logs
List inbound logs
Retrieve paginated inbound (received mail) delivery logs for the domain attached to the given mail order. Supports filtering by account, date range, status, sender, and recipient. Results are sorted by timestamp descending.
get/api/mail/v1/orders/{orderId}/logs/inbound
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
senderstring nullable
Example:user@example.com
Filter log entries by sender. Accepts a full email address or a domain.
recipientstring nullable
Example:recipient.com
Filter log entries by recipient. Accepts a full email address or a domain.
pageinteger
Example:1
Page number
per_pageinteger
Example:25
Number of items per page
Response
Success response
Example response
{
"data": [
{
"account": "user@example.com",
"rcpt": "recipient@example.com",
"rcpts": "recipient@example.com",
"client_ip": "192.168.0.1",
"from": "user@example.com",
"nrcpt": "1",
"timestamp": "2026-03-16T13:13:55Z",
"relay_events": [
{
"address_to": "user@example.com",
"relay": "server.example.com[192.168.0.1]:587",
"delay": "3.1",
"dsn": "2.0.0",
"status": "Sent",
"response": "250 2.0.0 Ok: queued as 6153112091D",
"time": "2026-03-16T13:13:55Z"
}
],
"status": "Delivered"
}
],
"meta": {
"current_page": 1,
"per_page": 15,
"total": 100
}
}