---
title: "Changes to List users"
method: GET
path: "/v3/users"
---

# Changes to List users

`GET /v3/users`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 36 revisions.

- **2025-10-17** `b05d4e3c6329`: 4 breaking, 1 warning, 1 info
- **2025-07-27** `7a85bad03e90`: 2 breaking, 5 warning, 8 info
- **2024-09-24** `375ce8bc9c64`: 1 breaking
- **2023-11-10** `135d8b0705d4`: 1 info
- **2022-10-10** `45e2df0efd62`: 1 breaking
- **2022-05-03** `5299c01f7f16`: 6 warning, 17 info
- **2022-02-16** `c42164095c7c`: 1 breaking

## Changes

- **2025-10-17** `b05d4e3c6329`: 4 breaking, 1 warning, 1 info
  - the response property `users/items/discovery_keys` became nullable for the status `200`
  - the response property `users/items/metadata` became nullable for the status `200`
  - the response property `users/items/nickname` became nullable for the status `200`
  - the response property `users/items/preferred_languages` became nullable for the status `200`
  - removed the optional property `users/items/session_tokens` from the response with the `200` status
  - the `profile_url` response's property default value `` was added for the status `200`
- **2025-07-27** `7a85bad03e90`: 2 breaking, 5 warning, 8 info
  - the `query` request parameter `active_mode` was restricted to a list of enum values
  - the `users/items/session_tokens/items/` response's property type changed from `object` to `string` for status `200`
  - deleted the `header` request parameter `Api-Token`
  - removed the optional property `users/items/description` from the response with the `200` status
  - removed the optional property `users/items/end_at` from the response with the `200` status
  - removed the optional property `users/items/local` from the response with the `200` status
  - removed the optional property `users/items/start_at` from the response with the `200` status
  - added the new optional `header` request parameter `api-token`
  - added the new enum value `activated` to the `query` request parameter `active_mode`
  - added the new enum value `all` to the `query` request parameter `active_mode`
  - added the new enum value `deactivated` to the `query` request parameter `active_mode`
  - added the optional property `users/items/state` to the response with the `200` status
  - added the optional property `users/items/unread_channel_count` to the response with the `200` status
  - added the optional property `users/items/unread_message_count` to the response with the `200` status
  - the response property `users/items/user_id` became required for the status `200`
- **2024-09-24** `375ce8bc9c64`: 1 breaking
  - the response property `users/items/` became nullable for the status `200`
- **2023-11-10** `135d8b0705d4`: 1 info
  - the `header` request parameter `Api-Token` became optional
- **2022-10-10** `45e2df0efd62`: 1 breaking
  - the `users/items/session_tokens/items/` response's property type changed from `string` to `object` for status `200`
- **2022-05-03** `5299c01f7f16`: 6 warning, 17 info
  - removed the optional property `users/items/connection_status` from the response with the `200` status
  - removed the optional property `users/items/friend_discovery_key` from the response with the `200` status
  - removed the optional property `users/items/friend_name` from the response with the `200` status
  - removed the optional property `users/items/meta_data` from the response with the `200` status
  - removed the optional property `users/items/plain_profile_url` from the response with the `200` status
  - removed the optional property `users/items/require_auth` from the response with the `200` status
  - added the optional property `users/items/access_token` to the response with the `200` status
  - added the optional property `users/items/created_at` to the response with the `200` status
  - added the optional property `users/items/description` to the response with the `200` status
  - added the optional property `users/items/discovery_keys` to the response with the `200` status
  - added the optional property `users/items/end_at` to the response with the `200` status
  - added the optional property `users/items/has_ever_logged_in` to the response with the `200` status
  - added the optional property `users/items/is_created` to the response with the `200` status
  - added the optional property `users/items/is_hide_me_from_friends` to the response with the `200` status
  - added the optional property `users/items/is_online` to the response with the `200` status
  - added the optional property `users/items/is_shadow_blocked` to the response with the `200` status
  - added the optional property `users/items/local` to the response with the `200` status
  - added the optional property `users/items/locale` to the response with the `200` status
  - added the optional property `users/items/metadata` to the response with the `200` status
  - added the optional property `users/items/phone_number` to the response with the `200` status
  - added the optional property `users/items/require_auth_for_profile_image` to the response with the `200` status
  - added the optional property `users/items/session_tokens` to the response with the `200` status
  - added the optional property `users/items/start_at` to the response with the `200` status
- **2022-02-16** `c42164095c7c`: 1 breaking
  - the `header` request parameter `Api-Token` became required

---

[Operation](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/docs/v3/users/get.md) - [API](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk.md) - [Page](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/changes/v3/users/get)