---
title: "Get IMAP unread count"
method: GET
path: "/api/v1/imap/unread"
---

# Get IMAP unread count

`GET /api/v1/imap/unread`

## Request

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

Get total and unread message counts for an IMAP mailbox.

## Query parameters

- `mailbox` string

## Response `200`

Unread count

- ImapUnreadResponse
  - `user` string
  - `provider` string
  - `mailbox` string
  - `messages` integer
  - `unseen` 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)