---
title: "View push preferences"
method: GET
path: "/v3/users/{user_id}/push_preference"
tags: ["User"]
---

# View push preferences

`GET /v3/users/{user_id}/push_preference`

## Request

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

## View push preferences

You can retrieves a user's notifications preferences. A push notification is a message that is immediately delivered to a user's device when the device is either idle or running the client app in the background.

> **Note**: Push notifications are only available for group channels. 
  

[https://sendbird.com/docs/chat/platform-api/v3/user/configuring-notification-preferences/get-push-notification-preferences#1-get-push-notification-preferences](https://sendbird.com/docs/chat/platform-api/v3/user/configuring-notification-preferences/get-push-notification-preferences#1-get-push-notification-preferences)

## Path parameters

- `user_id` string, required

## Headers

- `api-token` string

## Response `200`

Successful response

- ViewPushPreferencesResponse
  - `block_push_from_bots` boolean
  - `do_not_disturb` boolean
  - `enable_push_for_replies` boolean
  - `end_hour` integer
  - `end_min` integer
  - `push_blocked_bot_ids` string[]
  - `push_sound` string
  - `push_trigger_option` 'all' | 'mention_only' | 'off'
  - `snooze_enabled` boolean
  - `snooze_end_ts` integer
  - `snooze_start_ts` integer
  - `start_hour` integer
  - `start_min` integer
  - `timezone` string
  - `dnd_schedules` UpdatePushPreferencesRequestDndSchedulesInner[]
    - `day_of_week` 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday'
    - `time_windows` UpdatePushPreferencesRequestDndSchedulesInnerTimeWindowsInner[]
      - `start_hour` integer
      - `start_min` integer
      - `end_hour` integer
      - `end_min` integer

## Changes

- **2026-03-30** `9e53a5288df0`: 1 info
  - added the optional property `dnd_schedules` to the response with the `200` status
- **2025-07-27** `073cffd0bd87`: 1 info
  - removed the `default` enum value from the `push_trigger_option` response property for the response status `200`
- **2025-07-27** `7a85bad03e90`: 2 breaking, 5 warning, 1 info
  - the `snooze_end_ts` response's property type changed from `string` to `integer`, and format from no format to `int64` for status `200`
  - the `snooze_start_ts` response's property type changed from `string` to `integer`, and format from no format to `int64` for status `200`
  - deleted the `header` request parameter `Api-Token`
  - added the new `all` enum value to the `push_trigger_option` response property for the response status `200`
  - …4 more
- **2023-11-10** `135d8b0705d4`: 1 info
  - the `header` request parameter `Api-Token` became optional
- **2022-05-03** `5299c01f7f16`: 2 breaking, 3 info
  - the `snooze_end_ts` response's property type changed from `number` to `string` for status `200`
  - the `snooze_start_ts` response's property type changed from `number` to `string` for status `200`
  - added the optional property `block_push_from_bots` to the response with the `200` status
  - added the optional property `enable_push_for_replies` to the response with the `200` status
  - …1 more

[Operation history](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/changes/v3/users/:user_id/push_preference/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)