---
title: "Changes to Query users"
method: POST
path: "/users/search"
---

# Changes to Query users

`POST /users/search`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 139 revisions.

- **2026-07-15** `f8ecf435d25d`: 2 warning, 1 info
- **2026-07-09** `646d6658479b`: 2 breaking
- **2026-07-09** `7d57386313c7`: 4 breaking, 2 warning, 15 info
- **2026-07-09** `4b1a811c4179`: 6 breaking, 15 warning, 2 info
- **2026-06-16** `257509e66883`: 1 info
- **2026-06-03** `7adf4f33ea1a`: 1 info
- **2026-05-18** `8ec2edea6b20`: 4 warning
- **2026-04-06** `95af41a12111`: 4 warning, 8 info
- **2026-04-04** `9013edc21339`: 2 breaking

## Changes

- **2026-07-15** `f8ecf435d25d`: 2 warning, 1 info
  - added the new `not_implemented` enum value to the `code` response property for the response status `400`
  - added the new `not_implemented` enum value to the `code` response property for the response status `500`
  - added the new `gte` enum value to the request property `filters/items/operator`
- **2026-07-09** `646d6658479b`: 2 breaking
  - the `end_time` request property format changed from no format to `date-time`
  - the `start_time` request property format changed from no format to `date-time`
- **2026-07-09** `7d57386313c7`: 4 breaking, 2 warning, 15 info
  - the request's body type changed from no type to `object`
  - the `items/items/tenant/metadata` response's property type changed from no type to `object` for status `200`
  - the `items/items/type` response's property type changed from no type to `string` for status `200`
  - the `pagination` response's property type changed from no type to `object` for status `200`
  - added the new `service_account` enum value to the `items/items/type` response property for the response status `200`
  - added the new `user` enum value to the `items/items/type` response property for the response status `200`
  - added the new optional request property `end_time`
  - added the new optional request property `expand`
  - added the new optional request property `filters`
  - added the new optional request property `limit`
  - added the new optional request property `offset`
  - added the new optional request property `order`
  - added the new optional request property `roles`
  - added the new optional request property `sort`
  - added the new optional request property `start_time`
  - added the new optional request property `status`
  - added the new optional request property `type`
  - added the new optional request property `user_ids`
  - added the optional property `pagination/limit` to the response with the `200` status
  - added the optional property `pagination/offset` to the response with the `200` status
  - added the optional property `pagination/total` to the response with the `200` status
- **2026-07-09** `4b1a811c4179`: 6 breaking, 15 warning, 2 info
  - the request's body type changed from `object` to no type
  - the `items/items/tenant/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/tenant/metadata` response's property type changed from `object` to no type for status `200`
  - the `items/items/tenant/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/type` response's property type changed from `string` to no type for status `200`
  - the `pagination` response's property type changed from `object` to no type for status `200`
  - removed the request property `end_time`
  - removed the request property `expand`
  - removed the request property `filters`
  - removed the request property `limit`
  - removed the request property `offset`
  - removed the request property `order`
  - removed the request property `roles`
  - removed the request property `sort`
  - removed the request property `start_time`
  - removed the request property `status`
  - removed the request property `type`
  - removed the request property `user_ids`
  - removed the optional property `pagination/limit` from the response with the `200` status
  - removed the optional property `pagination/offset` from the response with the `200` status
  - removed the optional property `pagination/total` from the response with the `200` status
  - removed the `service_account` enum value from the `items/items/type` response property for the response status `200`
  - removed the `user` enum value from the `items/items/type` response property for the response status `200`
- **2026-06-16** `257509e66883`: 1 info
  - added the optional property `items/items/name` to the response with the `200` status
- **2026-06-03** `7adf4f33ea1a`: 1 info
  - added the optional property `items/items/metadata` to the response with the `200` status
- **2026-05-18** `8ec2edea6b20`: 4 warning
  - removed the optional property `details` from the response with the `400` status
  - removed the optional property `details` from the response with the `500` status
  - added the new `too_many_requests` enum value to the `code` response property for the response status `400`
  - added the new `too_many_requests` enum value to the `code` response property for the response status `500`
- **2026-04-06** `95af41a12111`: 4 warning, 8 info
  - removed the optional property `error` from the response with the `400` status
  - removed the optional property `error` from the response with the `500` status
  - removed the optional property `success` from the response with the `400` status
  - removed the optional property `success` from the response with the `500` status
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `500` status
  - added the optional property `details` to the response with the `400` status
  - added the optional property `details` to the response with the `500` status
  - added the optional property `http_status_code` to the response with the `400` status
  - added the optional property `http_status_code` to the response with the `500` status
  - added the optional property `message` to the response with the `400` status
  - added the optional property `message` to the response with the `500` status
- **2026-04-04** `9013edc21339`: 2 breaking
  - the `end_time` request property format changed from no format to `date-time`
  - the `start_time` request property format changed from no format to `date-time`

---

[Operation](https://skmtc.dev/flexprice/apis/flexprice-api/docs/users/search/post.md) - [API](https://skmtc.dev/flexprice/apis/flexprice-api.md) - [Page](https://skmtc.dev/flexprice/apis/flexprice-api/changes/users/search/post)