---
title: "Get a list of the top threads for a user."
method: GET
path: "/api/v4/users/me/top/threads"
tags: ["insights"]
---

# Get a list of the top threads for a user.

`GET /api/v4/users/me/top/threads`

Get a list of the top threads from public and private channels (the user is a member of and participating in the thread) for a given user.
##### Permissions
Must be logged in as the user.

## Query parameters

- `time_range` string, required
- `page` integer
- `per_page` integer
- `team_id` string

## Response `200`

Top threads retrieved successfully.

- 38cb7293TopThreadList
  - `has_next` boolean — Indicates if there is another page of top threads that can be fetched.
  - `items` 38cb7293TopThread[] — List of top threads.
    - `post` 38cb7293Post
      - `id` string
      - `create_at` integer — The time in milliseconds a post was created
      - `update_at` integer — The time in milliseconds a post was last updated
      - `delete_at` integer — The time in milliseconds a post was deleted
      - `edit_at` integer
      - `user_id` string
      - `channel_id` string
      - `root_id` string
      - `original_id` string
      - `message` string
      - `type` string
      - `props` object
      - `hashtag` string
      - `file_ids` string[]
      - `pending_post_id` string
      - `metadata` 38cb7293PostMetadata — Additional information used to display a post.
        - `embeds` object[] — Information about content embedded in the post including OpenGraph previews, image link previews, and message attachments. This field will be null if the post does not contain embedded content.
          - `type` 'image' | 'message_attachment' | 'opengraph' | 'link' — The type of content that is embedded in this point.
          - `url` string — The URL of the embedded content, if one exists.
          - `data` object — Any additional information about the embedded content. Only used at this time to store OpenGraph metadata. This field will be null for non-OpenGraph embeds.
        - `emojis` 38cb7293Emoji[] — The custom emojis that appear in this point or have been used in reactions to this post. This field will be null if the post does not contain custom emojis.
          - `id` string — The ID of the emoji
          - `creator_id` string — The ID of the user that made the emoji
          - `name` string — The name of the emoji
          - `create_at` integer — The time in milliseconds the emoji was made
          - `update_at` integer — The time in milliseconds the emoji was last updated
          - `delete_at` integer — The time in milliseconds the emoji was deleted
        - `files` 38cb7293FileInfo[] — The FileInfo objects for any files attached to the post. This field will be null if the post does not have any file attachments.
          - `id` string — The unique identifier for this file
          - `user_id` string — The ID of the user that uploaded this file
          - `post_id` string — If this file is attached to a post, the ID of that post
          - `create_at` integer — The time in milliseconds a file was created
          - `update_at` integer — The time in milliseconds a file was last updated
          - `delete_at` integer — The time in milliseconds a file was deleted
          - `name` string — The name of the file
          - `extension` string — The extension at the end of the file name
          - `size` integer — The size of the file in bytes
          - `mime_type` string — The MIME type of the file
          - `width` integer — If this file is an image, the width of the file
          - `height` integer — If this file is an image, the height of the file
          - `has_preview_image` boolean — If this file is an image, whether or not it has a preview-sized version
        - `images` object — An object mapping the URL of an external image to an object containing the dimensions of that image. This field will be null if the post or its embedded content does not reference any external images.
        - `reactions` 38cb7293Reaction[] — Any reactions made to this point. This field will be null if no reactions have been made to this post.
          - `user_id` string — The ID of the user that made this reaction
          - `post_id` string — The ID of the post to which this reaction was made
          - `emoji_name` string — The name of the emoji that was used for this reaction
          - `create_at` integer — The time in milliseconds this reaction was made
    - `channel_id` string
    - `channel_display_name` string
    - `channel_name` string
    - `Participants` string[]
    - `user_information` 38cb7293InsightUserInformation
      - `id` string
      - `first_name` string
      - `last_name` string
      - `nickname` string
      - `username` string
      - `last_picture_update` string
      - `create_at` integer

## Other responses

- `400` — Invalid or missing parameters in URL or request body
- `403` — Do not have appropriate permissions

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)