# Get a public list of users

`GET /directory_items.json`

Authentication: no security requirement declared for this operation.

Parameters:

- `period` (query, string, required)
  Type: string
  
  enum: ["daily","weekly","monthly","quarterly","yearly","all"]

- `order` (query, string, required)
  Type: string
  
  enum: ["likes_received","likes_given","topic_count","post_count","topics_entered","posts_read","days_visited"]

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

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

Responses:

- 200: directory items response

Content type: application/json

Type: any

- `directory_items` (required)
  Type: Array<object>
  
  Items:
    Type: object
    
    - `id` (required)
      Type: integer
    
    - `likes_received` (required)
      Type: integer
    
    - `likes_given` (required)
      Type: integer
    
    - `topics_entered` (required)
      Type: integer
    
    - `topic_count` (required)
      Type: integer
    
    - `post_count` (required)
      Type: integer
    
    - `posts_read` (required)
      Type: integer
    
    - `days_visited` (required)
      Type: integer
    
    - `user` (required)
      Type: object
      
      - `id` (required)
        Type: integer
      
      - `username` (required)
        Type: string
      
      - `name` (required)
        Type: string; nullable
      
      - `avatar_template` (required)
        Type: string
      
      - `title` (required)
        Type: string; nullable
      
      Additional properties: false
    
    Additional properties: false

- `meta` (required)
  Type: object
  
  - `last_updated_at` (required)
    Type: string; nullable
  
  - `total_rows_directory_items` (required)
    Type: integer
  
  - `load_more_directory_items` (required)
    Type: string
  
  Additional properties: false

Additional properties: false

## Examples

### cURL

```bash
curl -X GET 'https://discourse.example.com/directory_items.json?period=daily&order=likes_received'
```

### JavaScript

```javascript
const response = await fetch('https://discourse.example.com/directory_items.json?period=daily&order=likes_received', {
  method: 'GET',
});

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

### Python

```python
import requests

response = requests.get('https://discourse.example.com/directory_items.json?period=daily&order=likes_received')
print(response.text)
```