---
title: "Inbox unread and unreplied stats"
method: GET
path: "/creator-messages/stats"
tags: ["Creator Messages"]
---

# Inbox unread and unreplied stats

`GET /creator-messages/stats`

Shop-level counts for the creator DM inbox: total conversations, conversations with unread messages, conversations awaiting a shop reply, and the total unread-message count (the badge number). `unread_conversations` counts conversations; `unread_messages` sums the unread messages inside them — they are NOT the same. For per-creator unread detail, page `GET /conversations?unread_only=true`.

## Response `200`

Successful Response

- CreatorMessageStatsResponse — Inbox unread/unreplied stats for the shop. `unread_conversations` counts conversations with any unread message; `unread_messages` sums the unread messages inside them — a conversation with 5 unread adds 1 to the former and 5 to the latter.
  - `total_conversations` integer, required — Total conversations with message data for the shop.
  - `unread_conversations` integer, required — Conversations with at least one unread message.
  - `unreplied_conversations` integer, required — Conversations whose last message was from the creator (awaiting a shop reply).
  - `unread_messages` integer, required — SUM of unread messages across all conversations — the total unread badge number. Distinct from `unread_conversations`.
  - `has_data` boolean, required — True if the shop has any conversation with message data.

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) · [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/reacherapp/reacher-data-api/revisions/5eefff009b5b/schema)