---
title: "List users by flag"
method: GET
path: "/admin/users/list/{flag}.json"
tags: ["Users", "Admin"]
---

# List users by flag

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

## Path parameters

- `flag` 'active' | 'new' | 'staff' | 'suspended' | 'blocked' | 'suspect', required

## Query parameters

- `order` 'created' | 'last_emailed' | 'seen' | 'username' | 'email' | 'trust_level' | 'days_visited' | 'posts_read' | 'topics_viewed' | 'posts' | 'read_time'
- `asc` 'true'
- `page` integer
- `show_emails` boolean
- `stats` boolean
- `email` string
- `ip` string

## Response `200`

response

- object[]
  - `id` integer, required
  - `username` string, required
  - `name` string, nullable, required
  - `avatar_template` string, required
  - `email` string
  - `secondary_emails` unknown[]
    - unknown
  - `active` boolean, required
  - `admin` boolean, required
  - `moderator` boolean, required
  - `last_seen_at` string, nullable, required
  - `last_emailed_at` string, nullable, required
  - `created_at` string, required
  - `last_seen_age` number, nullable, required
  - `last_emailed_age` number, nullable, required
  - `created_at_age` number, nullable, required
  - `trust_level` integer, required
  - `manual_locked_trust_level` string, nullable, required
  - `title` string, nullable, required
  - `time_read` integer, required
  - `staged` boolean, required
  - `days_visited` integer, required
  - `posts_read_count` integer, required
  - `topics_entered` integer, required
  - `post_count` integer, required

---

[API](https://skmtc.net/discourse/apis/discourse-api-documentation.md) · [All operations](https://skmtc.net/discourse/apis/discourse-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/discourse/discourse-api-documentation/revisions/fb966f5bb63e/schema)