---
title: "View count preference of a channel"
method: GET
path: "/v3/users/{user_id}/count_preference/{channel_url}"
tags: ["User"]
---

# View count preference of a channel

`GET /v3/users/{user_id}/count_preference/{channel_url}`

## Request

- Base URL: `https://api-APP_ID.sendbird.com`
- URL: `https://api-APP_ID.sendbird.com/v3/users/{user_id}/count_preference/{channel_url}`
- Auth: none declared

## View count preference of a channel

This action retrieves a user's count preference of a specific group channel. The count preference allows a user to either retrieve the number of unread messages or unread mentioned messages, or both in a specific group channel.

If you want to update the total number count of a specific group channel, visit the [update count preference of a channel](https://sendbird.com/docs/chat/platform-api/v3/user/managing-unread-count/update-count-preference-of-a-channel).

https://sendbird.com/docs/chat/platform-api/v3/user/managing-unread-count/get-count-preference-of-a-channel#1-get-count-preference-of-a-channel

## Path parameters

- `user_id` string, required
- `channel_url` string, required

## Headers

- `api-token` string

## Response `200`

Successful response

- ViewCountPreferenceOfAChannelResponse
  - `count_preference` 'false' | 'all' | 'unread_message_count_only' | 'unread_mentioned_count_only'

## Changes

- **2025-07-27** `7a85bad03e90`: 5 warning, 2 info
  - deleted the `header` request parameter `Api-Token`
  - added the new `all` enum value to the `count_preference` response property for the response status `200`
  - added the new `false` enum value to the `count_preference` response property for the response status `200`
  - added the new `unread_mentioned_count_only` enum value to the `count_preference` response property for the response status `200`
  - …3 more
- **2023-11-10** `135d8b0705d4`: 1 info
  - the `header` request parameter `Api-Token` became optional
- **2022-02-16** `c42164095c7c`: 1 breaking
  - the `header` request parameter `Api-Token` became required

[Operation history](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/changes/v3/users/:user_id/count_preference/:channel_url/get.md)

---

[API](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk.md) - [All operations](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/llms.txt) - [OpenAPI document](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/revisions/9e53a5288df0?raw)