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 pageattachments(array of string): File names of the attachmentschannelId(string): Microsoft 365 connection (msgraph only)consumer(string): The module the mail goes to (one ofinvoice,desk,recruiting)createdAt(string (date-time)): When the mail was importedlastError(string): Why the mail was rejected or failedmailbox(string): The mailbox or platform address the mail came in onmailboxId(string (uuid)): The mailbox that received the mailmessageId(string): Graph message id or SES message idreceivedAt(string (date-time)): When the mail was receivedselectedClassification(string): Document type from "[CC:380]" in the subjectsender(string): Sender addresssource(string): msgraph: a Microsoft 365 mailbox; ses: the platform address (one ofmsgraph,ses)state(string): Import state; PENDING waits for the consumer (one ofPENDING,RETRY_MANUAL,ARCHIVED,REJECTED,DEAD_LETTER,COMPLETED,REJECTED_FINAL)subject(string): SubjectupdatedAt(string (date-time)): Time of the last state change
total(integer): Number of matching mails
Example 200 answer:
{
"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
curl -X GET 'https://api.mbcom.cloud/api/comms/v1/mail-intake/mails' \
-H "Authorization: Bearer $ACCESS_TOKEN"