# List users by flag

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

Authentication: no security requirement declared for this operation.

Parameters:

- `flag` (path, string, required)
  Type: string
  
  enum: ["active","new","staff","suspended","blocked","suspect"]

- `order` (query, string, optional)
  Type: string
  
  enum: ["created","last_emailed","seen","username","email","trust_level","days_visited","posts_read","topics_viewed","posts","read_time"]

- `asc` (query, string, optional)
  Type: string
  
  enum: ["true"]

- `page` (query, integer, optional)
  Type: integer

- `show_emails` (query, boolean, optional) - Include user email addresses in response. These requests will
be logged in the staff action logs.
  Type: boolean

- `stats` (query, boolean, optional) - Include user stats information
  Type: boolean

- `email` (query, string, optional) - Filter to the user with this email address
  Type: string

- `ip` (query, string, optional) - Filter to users with this IP address
  Type: string

Responses:

- 200: response

Content type: application/json

Type: Array<object>

minItems: 1

uniqueItems: true

Items:
  Type: object
  
  - `id` (required)
    Type: integer
  
  - `username` (required)
    Type: string
  
  - `name` (required)
    Type: string; nullable
  
  - `avatar_template` (required)
    Type: string
  
  - `email` (optional)
    Type: string
  
  - `secondary_emails` (optional)
    Type: Array<any>
    
    Items:
      Type: any
  
  - `active` (required)
    Type: boolean
  
  - `admin` (required)
    Type: boolean
  
  - `moderator` (required)
    Type: boolean
  
  - `last_seen_at` (required)
    Type: string; nullable
  
  - `last_emailed_at` (required)
    Type: string; nullable
  
  - `created_at` (required)
    Type: string
  
  - `last_seen_age` (required)
    Type: number; nullable
  
  - `last_emailed_age` (required)
    Type: number; nullable
  
  - `created_at_age` (required)
    Type: number; nullable
  
  - `trust_level` (required)
    Type: integer
  
  - `manual_locked_trust_level` (required)
    Type: string; nullable
  
  - `title` (required)
    Type: string; nullable
  
  - `time_read` (required)
    Type: integer
  
  - `staged` (required)
    Type: boolean
  
  - `days_visited` (required)
    Type: integer
  
  - `posts_read_count` (required)
    Type: integer
  
  - `topics_entered` (required)
    Type: integer
  
  - `post_count` (required)
    Type: integer

## Examples

### cURL

```bash
curl -X GET 'https://discourse.example.com/admin/users/list/active.json'
```

### JavaScript

```javascript
const response = await fetch('https://discourse.example.com/admin/users/list/active.json', {
  method: 'GET',
});

const data = await response.text();
```

### Python

```python
import requests

response = requests.get('https://discourse.example.com/admin/users/list/active.json')
print(response.text)
```