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

# Changes to List users

`GET /v2/users`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 4 revisions.

- **2026-09-30** `76616101e54a`: 1 info
- **2026-09-12** `bcd2910f7020`: 1 warning, 16 info

## Changes

- **2026-09-30** `76616101e54a`: 1 info
  - the security scope `users` was removed from the endpoint's security scheme `OAuth2`
- **2026-09-12** `bcd2910f7020`: 1 warning, 16 info
  - deleted the `query` request parameter `expand[]`
  - added the new optional `query` request parameter `cost_center_id[]`
  - added the new optional `query` request parameter `custom_field[]`
  - added the new optional `query` request parameter `department_id[]`
  - added the new optional `query` request parameter `email[]`
  - added the new optional `query` request parameter `legal_entity_id[]`
  - added the new optional `query` request parameter `load_custom_fields`
  - added the new optional `query` request parameter `location_id[]`
  - added the new optional `query` request parameter `manager_id[]`
  - added the new optional `query` request parameter `name`
  - added the new optional `query` request parameter `status[]`
  - added the new optional `query` request parameter `title_id[]`
  - added the optional property `items/items/cost_center_id` to the response with the `200` status
  - added the optional property `items/items/custom_fields` to the response with the `200` status
  - added the optional property `items/items/legal_entity_id` to the response with the `200` status
  - removed the `CLOSED` enum value from the `items/items/status/allOf[#/components/schemas/UserStatus]/` response property for the response status `200`
  - removed the `DELETED` enum value from the `items/items/status/allOf[#/components/schemas/UserStatus]/` response property for the response status `200`

---

[Operation](https://skmtc.dev/brex-com/apis/team-api/docs/v2/users/get.md) - [API](https://skmtc.dev/brex-com/apis/team-api.md) - [Page](https://skmtc.dev/brex-com/apis/team-api/changes/v2/users/get)