---
title: "Count unread emails"
method: GET
path: "/v1/emails/unread/count"
tags: ["Emails"]
---

# Count unread emails

`GET /v1/emails/unread/count`

## Request

- Base URL: `https://api.mailbeast.ai`
- URL: `https://api.mailbeast.ai/v1/emails/unread/count`
- Auth: HTTP bearer

Number of unread emails, optionally narrowed to specific mailboxes or a campaign. Emails outside a conversation have no read state and are not counted.

Requires one of the following scopes: `emails:read`, `emails:all`, `all:read`, `all:all`.

## Query parameters

- `mailbox` string
- `campaignId` string

## Response `200`

- UnreadCountApiResponseDto
  - `count` number, required: Number of unread emails matching the filters.

## Other responses

- `400`: The request body or parameters failed validation.
- `401`: Missing or invalid API key.
- `403`: The key lacks a required scope, or the plan does not include API access.
- `429`: Rate limit exceeded - retry after the interval in the Retry-After header.

---

[API](https://skmtc.dev/mailbeast/apis/mailbeast-public-api.md) · [All operations](https://skmtc.dev/mailbeast/apis/mailbeast-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailbeast/apis/mailbeast-public-api/revisions/6440ce0738a4?raw)