---
title: "Returns aggregate message counts for an account"
method: GET
path: "/messages/counts"
tags: ["message"]
---

# Returns aggregate message counts for an account

`GET /messages/counts`

Returns the unread message count across all conversations for the account associated with the given MLS member ID. Requires an MLS-scoped API key.

## Query parameters

- `member_mls_id` string, required

## Response `200`

Aggregate message counts

- MessageCounts
  - `unread` integer, required — Total unread messages across all conversations

## Other responses

- `401` — Unauthorized — API key is missing, inactive, or not an MLS-scoped key
- `404` — No agent found for the given member_mls_id, or the agent has no associated account

---

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