---
title: "POST /mail.message.list"
method: POST
path: "/mail.message.list"
tags: ["mail"]
---

# POST /mail.message.list

`POST /mail.message.list`

## Request body

- object
  - `select` string[]
  - `filter` unknown[]
    - unknown
  - `order` object
  - `pagination` object
    - `page` integer
    - `limit` integer
    - `offset` integer

## Response `200`

Success response

- object
  - `result` BitrixMailMessagedto[]
    - `id` integer
    - `mailboxId` integer
    - `mailboxEmail` string
    - `subject` string
    - `from` string
    - `to` string
    - `cc` string
    - `date` string
    - `isSeen` boolean
    - `hasAttachments` boolean
    - `url` string
    - `bindings` unknown[]
      - unknown
    - `body` string

## Changes

- **2026-05-21** `06bc370474b9` — 1 info
  - endpoint added
- **2026-03-18** `555e9f0892a0` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/bitrix24/apis/bitrix24-rest-v3-api/changes/mail.message.list/post.md)

---

[API](https://skmtc.dev/bitrix24/apis/bitrix24-rest-v3-api.md) · [All operations](https://skmtc.dev/bitrix24/apis/bitrix24-rest-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bitrix24/bitrix24-rest-v3-api/revisions/3660cc6bfaf5/schema)