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

# Get Unread Threads

`GET /threads/new`

List of unread threads (must be logged in).

Required scopes:
+ **read**

## Query parameters

- `limit` integer — Maximum number of result threads. The limit may get decreased if the value is too large (depending on the system configuration).
- `forum_id` integer — Id of the container forum to search for threads. Child forums of the specified forum will be included in the search.
- `data_limit` integer — Number of thread data to be returned. Default value is 20.

## Response `200`

Successful Response.

- object
  - `threads` object[], required
    - `thread_id` integer, required
  - `data` 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
  - `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)