HostingETLive

List access logs

GET/api/etlive/accesses

Returns mailbox access events for a domain or mailbox, including login/logout details and client information.

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

Not used by this endpoint.

protocol?string

Access protocol: all (default), imap, pop3, or webmail.

action?string

Access result: all (default), success, error, login, login-error, logout, or logout-error.

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/accesses?domain=string" \  -H "X-Api-Token: YOUR_API_TOKEN" \  -H "Accept: application/json"
{  "resources": [    null  ],  "pagination": {}}