## Mails received at the platform address, newest first (comms:read)

`GET /api/comms/v1/mail-intake/mails`

Module: Comms · operationId: `listMailIntakeMails` · Tag: Mailbox import · Auth: access token (`Authorization: Bearer <accessToken>`)

Reimport them with POST /mailbox-mails/{messageId}/reimport.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `state` | query | string |  | Comma-separated states, e.g. PENDING,REJECTED_FINAL |
| `limit` | query | integer |  | 1–200; anything else is 400 invalid (default `50`; max 200) |
| `offset` | query | integer |  | 0–10000; anything else is 400 invalid (default `0`; max 10000) |

### Responses

- **200** Mails (`application/json`)

Fields of the 200 answer:

- `items` (array of InboundMail): Mails of the page
  - `attachments` (array of string): File names of the attachments
  - `channelId` (string): Microsoft 365 connection (msgraph only)
  - `consumer` (string): The module the mail goes to (one of `invoice`, `desk`, `recruiting`)
  - `createdAt` (string (date-time)): When the mail was imported
  - `lastError` (string): Why the mail was rejected or failed
  - `mailbox` (string): The mailbox or platform address the mail came in on
  - `mailboxId` (string (uuid)): The mailbox that received the mail
  - `messageId` (string): Graph message id or SES message id
  - `receivedAt` (string (date-time)): When the mail was received
  - `selectedClassification` (string): Document type from "[CC:380]" in the subject
  - `sender` (string): Sender address
  - `source` (string): msgraph: a Microsoft 365 mailbox; ses: the platform address (one of `msgraph`, `ses`)
  - `state` (string): Import state; PENDING waits for the consumer (one of `PENDING`, `RETRY_MANUAL`, `ARCHIVED`, `REJECTED`, `DEAD_LETTER`, `COMPLETED`, `REJECTED_FINAL`)
  - `subject` (string): Subject
  - `updatedAt` (string (date-time)): Time of the last state change
- `total` (integer): Number of matching mails

Example 200 answer:

```json
{
  "items": [
    {
      "attachments": [
        "RE-2026-1187.pdf"
      ],
      "consumer": "invoice",
      "createdAt": "2026-11-18T06:47:13Z",
      "mailbox": "belege-k7m2qa@demo.on.beta.mbcom.dev",
      "mailboxId": "6a8c0e2f-4b5d-4c7e-9a1b-3c5d7e9f1a2b",
      "messageId": "0100018f2c7a1b3e-5d9f4c2a-7b1e-4a6d-9c3f-2e8a1b7d4c6f-000000",
      "receivedAt": "2026-11-18T06:47:12Z",
      "sender": "rechnung@buero-mueller.example",
      "source": "ses",
      "state": "PENDING",
      "subject": "Rechnung RE-2026-1187",
      "updatedAt": "2026-11-18T06:47:13Z"
    }
  ],
  "total": 1
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/comms/v1/mail-intake/mails' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
