---
title: "DirectoryItems_Directory_items (Discourse)"
description: "Directory Item Entries"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/discourse/Discourse.Users.DirectoryItems_Directory_items
original: https://documentation.invantive.eu/en/datamodels/discourse/Discourse.Users.DirectoryItems_Directory_items
updated: 2026-11-01T16:08:49Z
license: https://documentation.invantive.eu/en/
---

# DirectoryItems_Directory_items: Discourse Directory Item Entries

`read only` `REST`

- Catalog: `Discourse`
- Schema: `Users`
- Label: Directory Item Entries

Get a public list of users

Can only retrieve data.

## Summary

Get a public list of users

## API Source

- Endpoint: `/directory_items.json?period={period}`
- Operation: `get /directory_items.json?period={period}`

## Performance Characteristics

| Characteristic | Value |
|---|---:|
| Average access latency (ms) | 243 |
| Write rows per minute | 219 |

The result can be cached on the client.

## Parameters

| Name | Data Type | Required | Default | Documentation |
|---|---|:---:|---|---|
| `asc` | `` | [ ] |  | Values: True. |
| `order` | `` | [ ] |  | Values: likes_received, likes_given, topic_count, post_count, topics_entered, posts_read, days_visited. |
| `period` | `` | [x] |  | Values: daily, weekly, monthly, quarterly, yearly, all. |

## Table Columns

The columns of the table `DirectoryItems_Directory_items` are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

| Name | Data Type | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `days_visited` | `decimal` | Days Visited | [ ] | writable, `days_visited` |  |
| `id` | `decimal` | ID | [ ] | writable, `id` |  |
| `likes_given` | `decimal` | Likes Given | [ ] | writable, `likes_given` |  |
| `likes_received` | `decimal` | Likes Received | [ ] | writable, `likes_received` |  |
| `load_more_directory_items` | `varchar2` | Load More Directory Items | [ ] | filters on the platform, writable, `::ancestor.load_more_directory_items` |  |
| `post_count` | `decimal` | #Posts | [ ] | writable, `post_count` |  |
| `posts_read` | `decimal` | Posts Read | [ ] | writable, `posts_read` |  |
| `topic_count` | `decimal` | #Topics | [ ] | writable, `topic_count` |  |
| `topics_entered` | `decimal` | Topics Entered | [ ] | writable, `topics_entered` |  |
| `total_rows_directory_items` | `decimal` | Total Rows Directory Items | [ ] | filters on the platform, writable, `::ancestor.total_rows_directory_items` |  |
| `user_avatar_template` | `varchar2` | User Avatar Template | [ ] | writable, `user.avatar_template` |  |
| `user_id` | `decimal` | User ID | [ ] | writable, `user.id` |  |
| `user_name` | `varchar2` | User Name | [ ] | writable, `user.name` |  |
| `user_title` | `varchar2` | User Title | [ ] | writable | The JSON text of the nested object. |
| `user_username` | `varchar2` | User Name | [ ] | writable, `user.username` |  |



## Release Notes

What changed per release in the tables, columns, attributes and capabilities of the driver:

- [Discourse](/en/release-notes/drivers?driver=discourse)

### Changes of This Table, 26.0 to 27.0

<a id="DCE-27.0-D940"></a><a id="DCE-27.0-D941"></a><a id="DCE-27.0-D942"></a><a id="DCE-27.0-D943"></a><a id="DCE-27.0-D944"></a><a id="DCE-27.0-D945"></a><a id="DCE-27.0-D946"></a><a id="DCE-27.0-D947"></a><a id="DCE-27.0-D948"></a><a id="DCE-27.0-D949"></a><a id="DCE-27.0-D950"></a><a id="DCE-27.0-D951"></a><a id="DCE-27.0-D952"></a><a id="DCE-27.0-D953"></a><a id="DCE-27.0-D954"></a>

- `~` `days_visited` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `days_visited` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `~` `id` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `id` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `~` `likes_given` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `likes_given` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `~` `likes_received` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `likes_received` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `-` `load_more_directory_items`
- `~` `post_count` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `post_count` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `~` `posts_read` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `posts_read` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `~` `topic_count` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `topic_count` (`dotnet_data_type`: `decimal` &rarr; `int64`)

<details>
<summary>

10 more changes

</summary>

<div class="rn-item" id="DCE-27.0-D1069">

##### Parameter asc of Discourse.Users.DirectoryItems_Directory_items: dotnet data type changes

Dotnet data type changes from boolean to string.

<div class="rn-action">

**What to Do**

Check statements, views and scripts that use it before the upgrade.

</div>

<div class="rn-chips">

- **can break a statement**
- `boolean` &rarr; `string`
- importance 3

</div>

</div>

<div class="rn-item" id="DCE-27.0-D1070">

##### Parameter order of Discourse.Users.DirectoryItems_Directory_items: presence required changes

Presence required changes from false to true.

<div class="rn-action">

**What to Do**

Check statements, views and scripts that use it before the upgrade.

</div>

<div class="rn-chips">

- **can break a statement**
- `false` &rarr; `true`
- importance 3

</div>

</div>

<a id="DCE-27.0-D955"></a><a id="DCE-27.0-D956"></a><a id="DCE-27.0-D957"></a><a id="DCE-27.0-D958"></a><a id="DCE-27.0-D959"></a><a id="DCE-27.0-D1906"></a><a id="DCE-27.0-D1907"></a><a id="DCE-27.0-D1908"></a>

- `~` `topics_entered` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `topics_entered` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `-` `total_rows_directory_items`
- `~` `user_id` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `user_id` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `+` `meta_last_updated_at` (`varchar2`)
- `+` `meta_load_more_directory_items` (`varchar2`)
- `+` `meta_total_rows_directory_items` (`int64`)

</details>

[All changes of the driver, 26.0 to 27.0](/en/release-notes/drivers?driver=discourse&step=26.0-to-27.0#discourse-26.0-to-27.0)

