---
title: "List access logs"
method: GET
path: "/api/mail/v1/orders/{orderId}/logs/access"
tags: ["Mail: Logs"]
---

# List access logs

`GET /api/mail/v1/orders/{orderId}/logs/access`

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.

## Path parameters

- `orderId` string, required

## Query parameters

- `account` string, email, nullable
- `date` string, date, nullable
- `from_date` string, date-time, nullable
- `to_date` string, date-time, nullable
- `status` 'Successful' | 'Failed', nullable
- `protocol` 'imap' | 'pop3' | 'smtp', nullable
- `has_deletions` boolean, nullable
- `page` integer
- `per_page` integer

## Response `200`

Success response

- object
  - `data` MailV1LogsAccessAccessLogResource[] — Array of [`Mail.V1.Logs.Access.AccessLogResource`](#model/mailv1logsaccessaccesslogresource)
    - `account` string
    - `domain` string
    - `session` string
    - `protocol` string
    - `remote_ip` string
    - `login_time` string, date-time
    - `in` integer — Bytes received
    - `out` integer — Bytes sent
    - `deleted` integer
    - `expunged` integer
    - `trashed` integer
    - `logout_time` string, date-time
    - `timestamp` string, date-time
    - `app_name` string
    - `has_deletions` boolean
    - `result` string
    - `status` string
    - `is_important` boolean — True when the session deleted, expunged or trashed messages
  - `meta` CommonSchemaPaginationMetaSchema
    - `current_page` integer
    - `per_page` integer
    - `total` integer

## Other responses

- `401` — Unauthenticated response
- `404` — Error response
- `422` — Error response
- `500` — Error response

---

[API](https://skmtc.dev/hostinger/apis/hostinger-api.md) · [All operations](https://skmtc.dev/hostinger/apis/hostinger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hostinger/hostinger-api/revisions/53ccee45e5eb/schema)