---
title: "Get a public list of users"
method: GET
path: "/directory_items.json"
tags: ["Users"]
---

# Get a public list of users

`GET /directory_items.json`

## Query parameters

- `period` 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly' | 'all', required
- `order` 'likes_received' | 'likes_given' | 'topic_count' | 'post_count' | 'topics_entered' | 'posts_read' | 'days_visited', required
- `asc` 'true'
- `page` integer

## Response `200`

directory items response

- object
  - `directory_items` object[], required
    - `id` integer, required
    - `likes_received` integer, required
    - `likes_given` integer, required
    - `topics_entered` integer, required
    - `topic_count` integer, required
    - `post_count` integer, required
    - `posts_read` integer, required
    - `days_visited` integer, required
    - `user` object, required
      - `id` integer, required
      - `username` string, required
      - `name` string, nullable, required
      - `avatar_template` string, required
      - `title` string, nullable, required
  - `meta` object, required
    - `last_updated_at` string, nullable, required
    - `total_rows_directory_items` integer, required
    - `load_more_directory_items` string, required

---

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