HostingETLive

List incoming mail logs

GET/api/etlive/mailins

Returns inbound message trace logs for a domain or mailbox.

X-Api-Token<token>

API token used to authenticate requests.

In: header

Query Parameters

domain*string

Domain code: D followed by 9 digits. Example: D123456789.

mailbox?string

Optional email account code to restrict results to one mailbox. Example: EA12345678.

filter?string

Filter that processed the message: all (default), spamdyke, or qmailscanner.

protocol?string

Not used by this endpoint.

action?string

Message outcome: all (default), accept, denied, reject, spam-mark, spam-reject, virus-reject, or policy-reject.

date?string

Day to query, in YYYY-MM-DD format. Defaults to today.

from?string

Start time on date, in HH:MM:SS format and in the timezone of the authenticated user.

Default 00:00:00
to?string

End time on date, in HH:MM:SS format and in the timezone of the authenticated user.

Default 23:59:59
sortby?string

Sort field: create (default, order in which entries were recorded) or update. Other field names, such as login_at, are rejected with 422.

sortdir?string

Sort direction: desc (default, newest first) or asc.

since?string

Pagination cursor. To get the next page, pass the pagination.last value from the previous response here, keeping all other parameters unchanged. Use it with sortby=create (the default). When there are no more entries, the API returns 404.

count?string

Maximum number of entries per page. Defaults to 30.

Default 30
with_totals?string

Set to yes to include pagination.total_records, the total number of entries that match the filters.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/etlive/mailins?domain=string" \  -H "X-Api-Token: YOUR_API_TOKEN" \  -H "Accept: application/json"
{  "resources": [    null  ],  "pagination": {}}