For the complete documentation index, see llms.txt. This page is also available as Markdown.

List inbound logs

Retrieve paginated inbound (received mail) delivery logs for the domain attached to the given mail order.

List inbound logs

get

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.

Authorizations
AuthorizationstringRequired

API Token authentication

Path parameters
orderIdstringRequired

Order resource ID

Example: OR1a2b3c4d5e6f7g
Query parameters
accountstring · email · nullableOptional

Filter log entries by a specific email account

Example: user@example.com
datestring · date · nullableOptional

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

Example: 2026-03-16
from_datestring · date-time · nullableOptional

Date range start (RFC 3339)

Example: 2026-03-01T00:00:00Z
to_datestring · date-time · nullableOptional

Date range end (RFC 3339)

Example: 2026-03-31T23:59:59Z
statusstring · enum · nullableOptional

Filter log entries by status

Example: SuccessfulPossible values:
senderstring · nullableOptional

Filter log entries by sender. Accepts a full email address or a domain.

Example: user@example.com
recipientstring · nullableOptional

Filter log entries by recipient. Accepts a full email address or a domain.

Example: recipient.com
pageintegerOptional

Page number

Example: 1
per_pageinteger · max: 100Optional

Number of items per page

Default: 25Example: 25
Responses
200

Success response

application/json
get/api/mail/v1/orders/{orderId}/logs/inbound
GET /api/mail/v1/orders/{orderId}/logs/inbound HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "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",
      "is_spam": false
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 100
  }
}

Last updated

Was this helpful?