---
title: "Get unread message count"
method: GET
path: "/v1/agent/messages/unread-count"
tags: ["Agent Messaging"]
---

# Get unread message count

`GET /v1/agent/messages/unread-count`

Returns total unread count and per-sender breakdown.

## Query parameters

- `from` string

## Response `200`

Unread counts

- object
  - `unread_count` integer
  - `by_sender` object[]
    - `from` string
    - `count` integer

## Other responses

- `401` — Invalid or missing X-Agent-Key header

---

[API](https://skmtc.net/voidly/apis/voidly-api.md) · [All operations](https://skmtc.net/voidly/apis/voidly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voidly/voidly-api/revisions/decbe6fd40a8/schema)