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

# Top_Topic_listTopics: Discourse Top Topics

`read only` `REST`

- Catalog: `Discourse`
- Schema: `Topics`
- Label: Top Topics

Get the top topics

Can only retrieve data.

## Summary

Get the top topics

## API Source

- Endpoint: `/top.json`
- Operation: `get /top.json`

## Performance Characteristics

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

The result can be cached on the client.

## Table Columns

The columns of the table `Top_Topic_listTopics` 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 |
|---|---|---|:---:|---|---|
| `archetype` | `varchar2` | Archetype | [ ] | writable, `archetype` |  |
| `archived` | `char` | Archived | [ ] | writable, `archived` |  |
| `bookmarked` | `char` | Bookmarked | [ ] | writable, `bookmarked` |  |
| `bumped` | `char` | Bumped | [ ] | writable, `bumped` |  |
| `bumped_at` | `varchar2` | Bumped at | [ ] | writable, `bumped_at` |  |
| `can_create_topic` | `char` | Can Create Topic | [ ] | writable, `::ancestor.can_create_topic` |  |
| `can_have_answer` | `char` | Can Have Answer | [ ] | filters on the platform, writable, `can_have_answer` |  |
| `can_vote` | `char` | Can Vote | [ ] | filters on the platform, writable, `can_vote` |  |
| `category_id` | `decimal` | Category ID | [ ] | writable, `category_id` |  |
| `closed` | `char` | Closed | [ ] | writable, `closed` |  |
| `created_at` | `varchar2` | Created at | [ ] | writable, `created_at` |  |
| `draft` | `varchar2` | Draft | [ ] | writable | The JSON text of the nested object. |
| `draft_key` | `varchar2` | Draft Key | [ ] | writable, `::ancestor.draft_key` |  |
| `draft_sequence` | `decimal` | Draft Sequence | [ ] | writable, `::ancestor.draft_sequence` |  |
| `fancy_title` | `varchar2` | Fancy Title | [ ] | writable, `fancy_title` |  |
| `for_period` | `varchar2` | For Period | [ ] | writable, `::ancestor.for_period` |  |
| `has_accepted_answer` | `char` | Has Accepted Answer | [ ] | filters on the platform, writable, `has_accepted_answer` |  |
| `has_summary` | `char` | Has Summary | [ ] | writable, `has_summary` |  |
| `highest_post_number` | `decimal` | Highest Post Number | [ ] | writable, `highest_post_number` |  |
| `id` | `decimal` | ID | [ ] | writable, `id` |  |
| `image_url` | `varchar2` | Image URL | [ ] | writable | The JSON text of the nested object. |
| `last_posted_at` | `varchar2` | Last Posted at | [ ] | writable, `last_posted_at` |  |
| `last_poster_username` | `varchar2` | Last Poster Username | [ ] | writable, `last_poster_username` |  |
| `last_read_post_number` | `decimal` | Last Read Post Number | [ ] | writable, `last_read_post_number` |  |
| `like_count` | `decimal` | #Likes | [ ] | writable, `like_count` |  |
| `liked` | `char` | Liked | [ ] | writable, `liked` |  |
| `new_posts` | `decimal` | New Posts | [ ] | writable, `new_posts` |  |
| `notification_level` | `decimal` | Notification Level | [ ] | writable, `notification_level` |  |
| `per_page` | `decimal` | Per Page | [ ] | writable, `::ancestor.per_page` |  |
| `pinned` | `char` | Pinned | [ ] | writable, `pinned` |  |
| `pinned_globally` | `char` | Pinned Globally | [ ] | writable, `pinned_globally` |  |
| `posts_count` | `decimal` | #Posts | [ ] | writable, `posts_count` |  |
| `reply_count` | `decimal` | #Replies | [ ] | writable, `reply_count` |  |
| `slug` | `varchar2` | Slug | [ ] | writable, `slug` |  |
| `title` | `varchar2` | Title | [ ] | writable, `title` |  |
| `unpinned` | `varchar2` | Unpinned | [ ] | writable | The JSON text of the nested object. |
| `unread` | `decimal` | Unread | [ ] | writable, `unread` |  |
| `unseen` | `char` | Unseen | [ ] | writable, `unseen` |  |
| `user_voted` | `char` | User Voted | [ ] | filters on the platform, writable, `user_voted` |  |
| `views` | `decimal` | Views | [ ] | writable, `views` |  |
| `visible` | `char` | Visible | [ ] | writable, `visible` |  |
| `vote_count` | `int32` | Vote Count | [ ] | filters on the platform, writable, `vote_count` |  |

## Keys

| Key | Column | Refers to | Kind | Description |
|---|---|---|---|---|
| `Top_Topic_listTopics_category_id_cnd` | `category_id` | [Categories](Discourse.Categories.Categories)`.id` | Candidate | Not stated by Discourse; found on the data of the smoke forum on 2026-10-31, where every filled value is in the referenced table. |
| `Top_Topic_listTopics_last_poster_username_cnd` | `last_poster_username` | [Top_Users](Discourse.Topics.Top_Users)`.username` | Candidate | Not stated by Discourse; found on the data of the smoke forum on 2026-10-31, where every filled value is in the referenced table. |

## Referenced By

- [Top_Topic_listTopicsPosters](Discourse.Topics.Top_Topic_listTopicsPosters) `id` (Candidate)



## 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-D548"></a><a id="DCE-27.0-D549"></a><a id="DCE-27.0-D550"></a><a id="DCE-27.0-D551"></a><a id="DCE-27.0-D552"></a><a id="DCE-27.0-D553"></a><a id="DCE-27.0-D554"></a><a id="DCE-27.0-D555"></a><a id="DCE-27.0-D556"></a><a id="DCE-27.0-D557"></a><a id="DCE-27.0-D558"></a><a id="DCE-27.0-D559"></a><a id="DCE-27.0-D560"></a><a id="DCE-27.0-D561"></a><a id="DCE-27.0-D562"></a>

- `~` `category_id` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `category_id` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `~` `draft_sequence` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `draft_sequence` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `~` `highest_post_number` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `highest_post_number` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `~` `id` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `id` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `~` `last_read_post_number` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `last_read_post_number` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `~` `like_count` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `like_count` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `-` `new_posts`
- `~` `notification_level` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `notification_level` (`dotnet_data_type`: `decimal` &rarr; `int64`)

<details>
<summary>

17 more changes

</summary>

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

##### Discourse.Topics.Top_Topic_listTopics: type changes

Type of Discourse.Topics.Top_Topic_listTopics changes from table to tablefunction.

<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**
- `table` &rarr; `tablefunction`
- importance 3

</div>

</div>

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

##### Parameter per_page is added to Discourse.Topics.Top_Topic_listTopics

Optional.

<div class="rn-chips">

- importance 2

</div>

</div>

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

##### Parameter period is added to Discourse.Topics.Top_Topic_listTopics

Optional.

<div class="rn-chips">

- importance 2

</div>

</div>

<a id="DCE-27.0-D563"></a><a id="DCE-27.0-D564"></a><a id="DCE-27.0-D565"></a><a id="DCE-27.0-D566"></a><a id="DCE-27.0-D567"></a><a id="DCE-27.0-D568"></a><a id="DCE-27.0-D569"></a><a id="DCE-27.0-D570"></a><a id="DCE-27.0-D571"></a><a id="DCE-27.0-D572"></a><a id="DCE-27.0-D573"></a><a id="DCE-27.0-D1591"></a><a id="DCE-27.0-D1592"></a><a id="DCE-27.0-D1593"></a>

- `~` `per_page` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `per_page` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `~` `posts_count` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `posts_count` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `~` `reply_count` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `reply_count` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `~` `unpinned` (`database_data_type`: `varchar2` &rarr; `char`)
- `~` `unpinned` (`dotnet_data_type`: `string` &rarr; `boolean`)
- `-` `unread`
- `~` `views` (`database_data_type`: `decimal` &rarr; `int64`)
- `~` `views` (`dotnet_data_type`: `decimal` &rarr; `int64`)
- `+` `featured_link` (`varchar2`)
- `+` `op_like_count` (`int64`)
- `+` `unread_posts` (`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)

