---
title: "get all mails"
method: GET
path: "/api/v1/mails/{mailServerID}/messages"
tags: ["messages"]
---

# get all mails

`GET /api/v1/mails/{mailServerID}/messages`

## Path parameters

- `mailServerID` string, required

## Query parameters

- `page` number
- `count` number
- `direction` 'incoming' | 'outgoing', required
- `state` string
- `subject` string
- `from` string
- `to` string
- `isTrash` boolean

## Response `200`

OK

- MailMessages
  - `status` string
  - `data` object
    - `total` number
    - `messages` MailMessage[]
      - `createdAt` string
      - `direction` string
      - `from` string
      - `hasHtml` boolean
      - `isDev` boolean
      - `isFree` boolean
      - `spamScore` boolean
      - `subject` string
      - `to` string
      - `text` string
      - `status` object
        - `event` string
        - `state` string
        - `details` string
      - `id` string
      - `spamReson` object

## Other responses

- `400` — Bad Request
- `404` — Mail Server not found
- `500` — Unexpected error

---

[API](https://skmtc.net/liara-cloud/apis/liara-mail-api-documentaion.md) · [All operations](https://skmtc.net/liara-cloud/apis/liara-mail-api-documentaion/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liara-cloud/liara-mail-api-documentaion/versions/5ae39ee353b2/schema)