---
title: "Get Threads"
method: GET
path: "/threads"
tags: ["Threads"]
---

# Get Threads

`GET /threads`

List of threads in a forum (with pagination).

Required scopes:
+ **read**

## Query parameters

- `forum_id` integer — Id of the containing forum.
- `tab` string — Tab to get threads from.
- `state` 'active' | 'closed' — Thread state. Works only if **forum_id** is set.
- `period` 'day' | 'week' | 'month' | 'year' — Filter to get only threads created within the selected period. Works only if **forum_id** is set.
- `title` string — Thread title.
- `title_only` boolean — Search only in titles.
- `creator_user_id` integer — Filter to get only threads created by the specified user.
- `sticky` boolean — Filter to get only sticky or non-sticky threads. By default, all threads will be included and sticky ones will be at the top of the result on the first page. In mixed mode, sticky threads are not counted towards **threads_total** and does not affect pagination.
- `prefix_ids[]` integer[] — Filter to get only threads with the specified prefix.
- `prefix_ids_not[]` integer[] — Filter to get only threads without the specified prefix.
- `thread_tag_id` integer — Filter to get only threads with the specified tag.
- `page` integer — Page number of threads.
- `limit` integer — Number of threads in a page.
- `order` 'post_date' | 'last_post_date' | 'reply_count' | 'reply_count_asc' | 'first_post_likes' | 'vote_count' — Ordering of threads.
- `direction` 'asc' | 'desc' — Direction of threads ordering.
- `thread_create_date` integer — Filter threads by creation date. Only works with 'thread_create_date' and 'thread_create_date_reverse' ordering.
- `thread_update_date` integer — Filter threads by update date. Only works with 'thread_update_date' and 'thread_update_date_reverse' ordering.
- `fields_include` string[]

## Response `200`

Successful Response.

- object
  - `threads` RespThreadModel[], required
    - `thread_id` integer, required
    - `forum_id` integer, required
    - `thread_title` string, required
    - `thread_view_count` integer, required
    - `creator_user_id` integer, required
    - `creator_username` string, required
    - `creator_username_html` string, required
    - `thread_create_date` integer, required
    - `thread_update_date` integer, required
    - `thread_reply_group_id` integer, required
    - `thread_comment_ignore_group` integer, required
    - `thread_last_bump_date` integer, required
    - `user_is_ignored` boolean, required
    - `thread_post_count` integer, required
    - `thread_is_liked` boolean, required
    - `thread_is_bumped` boolean, required
    - `thread_is_published` boolean, required
    - `thread_is_deleted` boolean, required
    - `thread_is_sticky` boolean, required
    - `thread_is_closed` boolean, required
    - `thread_is_followed` boolean, required
    - `thread_is_starred` boolean, required
    - `thread_hide_contacts` boolean
    - `thread_allow_ask_hidden_content` boolean
    - `first_post` RespPostModel, required
      - `post_id` integer, required
      - `thread_id` integer, required
      - `poster_user_id` integer, required
      - `poster_username` string, required
      - `poster_username_html` string, required
      - `poster_is_banned` integer, required
      - `poster_is_staff` integer, required
      - `post_create_date` integer, required
      - `post_body` string, required
      - `post_body_html` string, required
      - `post_body_plain_text` string, required
      - `signature` string, required
      - `signature_html` string, required
      - `signature_plain_text` string, required
      - `post_like_count` integer, required
      - `delete_info` object
        - `user_id` integer, required
        - `username` string, required
        - `username_html` string, required
        - `date` integer, required
        - `reason` string, required
      - `user_is_ignored` boolean, required
      - `post_is_sticked` boolean, required
      - `post_is_published` boolean, required
      - `post_is_deleted` boolean, required
      - `post_update_date` integer, required
      - `post_is_first_post` boolean, required
      - `post_is_liked` boolean, required
      - `links` object, required
        - `permalink` string, required
        - `detail` string, required
        - `thread` string, required
        - `poster` string, required
        - `likes` string, required
        - `report` string, required
        - `poster_avatar` string, required
      - `permissions` object, required
        - `view` boolean, required
        - `edit` boolean, required
        - `delete` boolean, required
        - `undelete` boolean, required
        - `reply` boolean, required
        - `like` boolean, required
        - `report` boolean, required
        - `stick` boolean, required
        - `unstick` boolean, required
      - `thread_is_deleted` boolean, required
      - `thread_is_closed` boolean, required
      - `thread` RespThreadModel, required — recursive
    - `thread_prefixes` object[], required
      - `prefix_id` integer
      - `prefix_title` string
    - `thread_tags` object, required
    - `links` object, required
      - `permalink` string, required
      - `detail` string, required
      - `followers` string, required
      - `forum` string, required
      - `posts` string, required
      - `first_poster` string, required
      - `first_poster_avatar` string, required
      - `first_post` string, required
      - `last_poster` string
      - `last_post` string
    - `permissions` object, required
      - `view` boolean, required
      - `delete` boolean, required
      - `follow` boolean, required
      - `post` boolean, required
      - `edit` boolean, required
      - `bump` object, required
        - `can` boolean, required
        - `available_count` integer, required
        - `error` string, required
        - `next_available_time` integer, required
    - `node_title` string, required
    - `last_post` RespPostModel
      - `post_id` integer, required
      - `thread_id` integer, required
      - `poster_user_id` integer, required
      - `poster_username` string, required
      - `poster_username_html` string, required
      - `poster_is_banned` integer, required
      - `poster_is_staff` integer, required
      - `post_create_date` integer, required
      - `post_body` string, required
      - `post_body_html` string, required
      - `post_body_plain_text` string, required
      - `signature` string, required
      - `signature_html` string, required
      - `signature_plain_text` string, required
      - `post_like_count` integer, required
      - `delete_info` object
        - `user_id` integer, required
        - `username` string, required
        - `username_html` string, required
        - `date` integer, required
        - `reason` string, required
      - `user_is_ignored` boolean, required
      - `post_is_sticked` boolean, required
      - `post_is_published` boolean, required
      - `post_is_deleted` boolean, required
      - `post_update_date` integer, required
      - `post_is_first_post` boolean, required
      - `post_is_liked` boolean, required
      - `links` object, required
        - `permalink` string, required
        - `detail` string, required
        - `thread` string, required
        - `poster` string, required
        - `likes` string, required
        - `report` string, required
        - `poster_avatar` string, required
      - `permissions` object, required
        - `view` boolean, required
        - `edit` boolean, required
        - `delete` boolean, required
        - `undelete` boolean, required
        - `reply` boolean, required
        - `like` boolean, required
        - `report` boolean, required
        - `stick` boolean, required
        - `unstick` boolean, required
      - `thread_is_deleted` boolean, required
      - `thread_is_closed` boolean, required
      - `thread` RespThreadModel, required — recursive
    - `contest` object
      - `type` string, required
      - `finish_date` integer, required
      - `now_count_members` integer, required
      - `needed_members` integer, required
      - `is_finished` integer, required
      - `count_winners` integer, required
      - `require_like_count` integer, required
      - `require_total_like_count` integer, required
      - `prize_type` string, required
      - `prize_type_phrase` string, required
      - `prize_data` union, required
        - object
        - integer
      - `prize_cost` integer, required
      - `is_money_places` integer, required
      - `chance_to_win` number, required
      - `prize_per_winner` integer, nullable, required
      - `prize_places` object, nullable, required
        - `place` integer, required
        - `amount` integer, required
      - `already_participate` boolean, required
      - `permissions` object, required
        - `can_finish` boolean, required
        - `can_participate` boolean, required
        - `can_view_user_list` boolean, required
  - `tabTitle` string, nullable, required
  - `forum` object
    - `forum_id` integer, required
    - `forum_title` string, required
    - `forum_description` string, required
    - `forum_thread_count` integer, required
    - `forum_post_count` integer, required
    - `forum_prefixes` unknown[], required
      - unknown
    - `thread_default_prefix_id` integer, required
    - `thread_prefix_is_required` boolean, required
    - `links` object, required
      - `permalink` string, required
      - `detail` string, required
      - `sub-categories` string, required
      - `sub-forums` string, required
      - `threads` string, required
      - `followers` string, required
    - `permissions` object, required
      - `view` boolean, required
      - `edit` boolean, required
      - `delete` boolean, required
      - `create_thread` boolean, required
      - `upload_attachment` boolean, required
      - `tag_thread` boolean, required
      - `follow` boolean, required
    - `forum_is_followed` boolean, required
  - `threads_total` integer, required
  - `links` object, required
    - `pages` integer, required
    - `page` integer, required
    - `next` string, required
  - `system_info` RespSystemInfo, required
    - `visitor_id` integer, required
    - `time` integer, required
    - `log_id` integer, required

## Other responses

- `401` — Unauthorized
- `403` — Error Response.

---

[API](https://skmtc.net/lolz/apis/lolzteam-public-api-forum.md) · [All operations](https://skmtc.net/lolz/apis/lolzteam-public-api-forum/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lolz/lolzteam-public-api-forum/versions/3efcdbc40994/schema)