---
title: "List IMAP messages"
method: GET
path: "/api/v1/imap/messages"
---

# List IMAP messages

`GET /api/v1/imap/messages`

## Request

- Base URL: `https://localhost:3000`
- URL: `https://localhost:3000/api/v1/imap/messages`
- Auth: OAuth 2 (authorization code, authorization URL `/oauth/authorize`, token URL `/oauth/token`)

List recent IMAP messages (headers only) from a mailbox.

## Query parameters

- `mailbox` string
- `max_results` integer
- `unread_only` boolean

## Response `200`

Message header list

- ImapMessagesResponse
  - `user` string
  - `provider` string
  - `mailbox` string
  - `unread_only` boolean
  - `messages` ImapMessageHeader[]
    - `id` string: IMAP message sequence number
    - `subject` string
    - `from` string
    - `date` string
    - `message_id_header` string
    - `is_read` boolean
  - `count` integer

## Other responses

- `401`: Authentication required
- `500`: Internal server error
- `503`: IMAP not configured for this user

---

[API](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api.md) · [All operations](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/revisions/e25648ba6027?raw)