---
title: "Changes to Unread counts"
method: GET
path: "/unread"
---

# Changes to Unread counts

`GET /unread`

> Every recorded change to this operation, newest first.
> 576 revisions in range; 3 not diffed.

## Timeline

Changed in 9 of 576 revisions.

- **2026-10-22** `6b8025dc9af1`: 2 info
- **2026-10-12** `30f95dce0284`: 2 info
- **2025-11-17** `080427f514b6`: 1 info
- **2025-07-31** `ff8af70dc683`: 1 breaking
- **2025-07-18** `ecf82915c7e4`: 1 info
- **2024-09-05** `c008f63f0618`: 2 info
- **2024-04-29** `a49249cffc7a`: 2 info
- **2024-02-14** `9abea6d94d53`: 3 warning, 2 info
- **2023-10-29** `477a2a0d93c5`: 1 info

## Changes

- **2026-10-22** `6b8025dc9af1`: 2 info
  - added the new optional `query` request parameter `include_large_channels`
  - added the required property `channels/items/has_unread` to the response with the `200` status
- **2026-10-12** `30f95dce0284`: 2 info
  - added the optional property `cooldown_remaining_ms` to the response with the `400` status
  - added the optional property `cooldown_remaining_ms` to the response with the `429` status
- **2025-11-17** `080427f514b6`: 1 info
  - added the new optional `query` request parameter `user_id`
- **2025-07-31** `ff8af70dc683`: 1 breaking
  - the response property `total_unread_count_by_team` became optional for the status `200`
- **2025-07-18** `ecf82915c7e4`: 1 info
  - added the required property `total_unread_count_by_team` to the response with the `200` status
- **2024-09-05** `c008f63f0618`: 2 info
  - added the optional property `unrecoverable` to the response with the `400` status
  - added the optional property `unrecoverable` to the response with the `429` status
- **2024-04-29** `a49249cffc7a`: 2 info
  - api tag `product:chat` added
  - api tag `Channels` removed
- **2024-02-14** `9abea6d94d53`: 3 warning, 2 info
  - the optional response header `X-RateLimit-Limit` removed for the status `429`
  - the optional response header `X-RateLimit-Remaining` removed for the status `429`
  - the optional response header `X-RateLimit-Reset` removed for the status `429`
  - added the required property `threads` to the response with the `200` status
  - added the required property `total_unread_threads_count` to the response with the `200` status
- **2023-10-29** `477a2a0d93c5`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/getstream/apis/stream-api/docs/unread/get.md) - [API](https://skmtc.dev/getstream/apis/stream-api.md) - [Page](https://skmtc.dev/getstream/apis/stream-api/changes/unread/get)