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

# Changes to List users

`GET /users`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 29 revisions.

- **2026-07-23** `ae5572197e85`: 17 breaking, 9 warning
- **2026-06-26** `462bd995dee8`: 1 info
- **2026-05-15** `f6aec844c9f2`: 6 breaking, 3 warning, 10 info
- **2026-05-06** `e832ef1d24dc`: 9 info

## Changes

- **2026-07-23** `ae5572197e85`: 17 breaking, 9 warning
  - the response property `items/items/client_metadata` became nullable for the status `200`
  - the response property `items/items/client_read_only_metadata` became nullable for the status `200`
  - the response property `items/items/country_code` became nullable for the status `200`
  - the response property `items/items/display_name` became nullable for the status `200`
  - the response property `items/items/primary_email` became nullable for the status `200`
  - the response property `items/items/profile_image_url` became nullable for the status `200`
  - the response property `items/items/restricted_by_admin_private_details` became nullable for the status `200`
  - the response property `items/items/restricted_by_admin_reason` became nullable for the status `200`
  - the response property `items/items/restricted_reason` became nullable for the status `200`
  - the response property `items/items/selected_team` became nullable for the status `200`
  - the response property `items/items/selected_team/client_metadata` became nullable for the status `200`
  - the response property `items/items/selected_team/client_read_only_metadata` became nullable for the status `200`
  - the response property `items/items/selected_team/profile_image_url` became nullable for the status `200`
  - the response property `items/items/selected_team/server_metadata` became nullable for the status `200`
  - the response property `items/items/selected_team_id` became nullable for the status `200`
  - the response property `items/items/server_metadata` became nullable for the status `200`
  - the response property `pagination/next_cursor` became nullable for the status `200`
  - added the new `undefined` enum value to the `items/items/country_code` response property for the response status `200`
  - added the new `undefined` enum value to the `items/items/display_name` response property for the response status `200`
  - added the new `undefined` enum value to the `items/items/primary_email` response property for the response status `200`
  - added the new `undefined` enum value to the `items/items/profile_image_url` response property for the response status `200`
  - added the new `undefined` enum value to the `items/items/restricted_by_admin_private_details` response property for the response status `200`
  - added the new `undefined` enum value to the `items/items/restricted_by_admin_reason` response property for the response status `200`
  - added the new `undefined` enum value to the `items/items/selected_team/profile_image_url` response property for the response status `200`
  - added the new `undefined` enum value to the `items/items/selected_team_id` response property for the response status `200`
  - added the new `undefined` enum value to the `pagination/next_cursor` response property for the response status `200`
- **2026-06-26** `462bd995dee8`: 1 info
  - added the new optional `query` request parameter `excluded_email_domains`
- **2026-05-15** `f6aec844c9f2`: 6 breaking, 3 warning, 10 info
  - the `query` request parameter `desc` was restricted to a list of enum values
  - the `query` request parameter `include_anonymous` was restricted to a list of enum values
  - the `query` request parameter `include_restricted` was restricted to a list of enum values
  - the `query` request parameter `only_anonymous` was restricted to a list of enum values
  - the `query` request parameter `order_by` was restricted to a list of enum values
  - for the `query` request parameter `limit`, the type changed from `number` to `integer`
  - added the new `anonymous` enum value to the `items/items/restricted_reason/type` response property for the response status `200`
  - added the new `email_not_verified` enum value to the `items/items/restricted_reason/type` response property for the response status `200`
  - added the new `restricted_by_administrator` enum value to the `items/items/restricted_reason/type` response property for the response status `200`
  - added the new enum value `false` to the `query` request parameter `desc`
  - added the new enum value `false` to the `query` request parameter `include_anonymous`
  - added the new enum value `false` to the `query` request parameter `include_restricted`
  - added the new enum value `false` to the `query` request parameter `only_anonymous`
  - added the new enum value `last_active_at` to the `query` request parameter `order_by`
  - added the new enum value `signed_up_at` to the `query` request parameter `order_by`
  - added the new enum value `true` to the `query` request parameter `desc`
  - added the new enum value `true` to the `query` request parameter `include_anonymous`
  - added the new enum value `true` to the `query` request parameter `include_restricted`
  - added the new enum value `true` to the `query` request parameter `only_anonymous`
- **2026-05-06** `e832ef1d24dc`: 9 info
  - added the new optional `query` request parameter `include_restricted`
  - added the new optional `query` request parameter `only_anonymous`
  - added the optional property `items/items/country_code` to the response with the `200` status
  - added the optional property `items/items/restricted_by_admin_private_details` to the response with the `200` status
  - added the optional property `items/items/restricted_by_admin_reason` to the response with the `200` status
  - added the optional property `items/items/restricted_reason` to the response with the `200` status
  - added the required property `items/items/is_restricted` to the response with the `200` status
  - added the required property `items/items/restricted_by_admin` to the response with the `200` status
  - added the required property `items/items/risk_scores` to the response with the `200` status

---

[Operation](https://skmtc.dev/hexclave/apis/hexclave-rest-api-3/docs/users/get.md) - [API](https://skmtc.dev/hexclave/apis/hexclave-rest-api-3.md) - [Page](https://skmtc.dev/hexclave/apis/hexclave-rest-api-3/changes/users/get)
