---
title: "Changes to List users by flag"
method: GET
path: "/admin/users/list/{flag}.json"
---

# Changes to List users by flag

`GET /admin/users/list/{flag}.json`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 52 revisions.

- **2025-10-14** `e90da7406181`: 1 info
- **2024-01-27** `2df0ac845943`: 1 breaking
- **2023-08-11** `7b91dc8ad5ad`: 3 info
- **2022-03-05** `e1108b0434c0`: 20 breaking, 7 warning, 27 info

## Changes

- **2025-10-14** `e90da7406181`: 1 info
  - api operation id `adminListUsers` removed and replaced with `adminListUsersFlag`
- **2024-01-27** `2df0ac845943`: 1 breaking
  - removed the required property `items/flag_level` from the response with the `200` status
- **2023-08-11** `7b91dc8ad5ad`: 3 info
  - added the new optional `query` request parameter `email`
  - added the new optional `query` request parameter `ip`
  - added the new optional `query` request parameter `stats`
- **2022-03-05** `e1108b0434c0`: 20 breaking, 7 warning, 27 info
  - the response property `items/created_at_age` became nullable for the status `200`
  - the response property `items/last_emailed_age` became nullable for the status `200`
  - the response property `items/last_emailed_at` became nullable for the status `200`
  - the response property `items/last_seen_age` became nullable for the status `200`
  - the response property `items/last_seen_at` became nullable for the status `200`
  - the response property `items/title` became nullable for the status `200`
  - the `items/avatar_template` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `items/created_at` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `items/created_at_age` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `items/email` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `items/last_emailed_age` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `items/last_emailed_at` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `items/last_seen_age` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `items/last_seen_at` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `items/time_read` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `items/username` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `items/created_at_age` response's property type changed from `string` to `number, null` for status `200`
  - the `items/last_emailed_age` response's property type changed from `string` to `number, null` for status `200`
  - the `items/last_seen_age` response's property type changed from `string` to `number, null` for status `200`
  - the `items/time_read` response's property type changed from `string` to `integer` for status `200`
  - deleted the `query` request parameter `ascending`
  - removed the optional property `items/blocked` from the response with the `200` status
  - removed the optional property `items/suspended` from the response with the `200` status
  - removed the optional property `items/suspended_at` from the response with the `200` status
  - removed the optional property `items/suspended_till` from the response with the `200` status
  - removed the optional property `items/trust_level_locked` from the response with the `200` status
  - removed the optional property `items/username_lower` from the response with the `200` status
  - api operation id `adminListUsers` was added
  - api tag `Admin` added
  - added the new optional `query` request parameter `asc`
  - added the optional property `items/secondary_emails` to the response with the `200` status
  - the response property `items/active` became required for the status `200`
  - the response property `items/admin` became required for the status `200`
  - the response property `items/avatar_template` became required for the status `200`
  - the response property `items/created_at` became required for the status `200`
  - the response property `items/created_at_age` became required for the status `200`
  - the response property `items/days_visited` became required for the status `200`
  - the response property `items/flag_level` became required for the status `200`
  - the response property `items/id` became required for the status `200`
  - the response property `items/last_emailed_age` became required for the status `200`
  - …14 more

---

[Operation](https://skmtc.dev/discourse/apis/discourse-api-documentation/docs/admin/users/list/:flag.json/get.md) - [API](https://skmtc.dev/discourse/apis/discourse-api-documentation.md) - [Page](https://skmtc.dev/discourse/apis/discourse-api-documentation/changes/admin/users/list/:flag.json/get)