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

# List threads

`GET /v2/threads`

List threads of comments on a record or list entry.

To view threads on records, you will need the `object_configuration:read` and `record_permission:read` scopes.

To view threads on list entries, you will need the `list_configuration:read` and `list_entry:read` scopes.

Required scopes: `comment:read`.

## Query parameters

- `record_id` string, uuid — Use this parameter to filter to threads on a specific record. Must be passed with `object`.
- `object` string — Use this parameter to filter to threads on a specific record. Must be passed with `record_id`. Accepts either a slug or an ID.
- `entry_id` string, uuid — Use this parameter to filter to threads on a specific entry. Must be passed with `list`.
- `list` string — Use this parameter to filter to threads on a specific entry. Must be passed with `entry_id`. Accepts either a slug or an ID.
- `limit` integer — The maximum number of results to return. The default is `10` and the maximum is `50`. See the [full guide to pagination here](/docs/pagination).
- `offset` integer — The number of results to skip over before returning. The default is `0`. See the [full guide to pagination here](/docs/pagination).

## Response `200`

Success

- object — Success
  - `data` Thread[], required
    - `id` object, required
      - `workspace_id` string, uuid, required — The ID of the workspace the thread belongs to.
      - `thread_id` string, uuid, required — The ID of the thread.
    - `comments` Comment[], required — An array of comments in the thread, sorted by `created_at`.
      - `id` object, required
        - `workspace_id` string, uuid, required — The ID of the workspace the comment belongs to.
        - `comment_id` string, uuid, required — The ID of the comment.
      - `thread_id` string, uuid, required — The ID of the thread the comment belongs to.
      - `content_plaintext` string, required — A plaintext representation of the content of the comment. References to workspace members are cast into email addresses, all other stylistic elements are removed.
      - `entry` object, nullable, required — The entry the comment belongs to, `null` for comments on records.
        - `entry_id` string, uuid, required — The ID of the entry the comment belongs to.
        - `list_id` string, uuid, required — The ID of the list the entry belongs to.
      - `record` object, required — The record the comment belongs to.
        - `record_id` string, uuid, required — The ID of the record the comment belongs to.
        - `object_id` string, uuid, required — The ID of the object the record belongs to.
      - `resolved_at` string, nullable, required — Whether the comment is resolved.
      - `resolved_by` object, required — The actor that resolved this comment.
        - `id` string, nullable — An ID to identify the actor.
        - `type` 'api-token' | 'workspace-member' | 'system' | 'app', nullable — The type of actor. [Read more information on actor types here](/docs/actors).
      - `created_at` string, required — When the note was created.
      - `author` object, required — Who wrote this comment. Note that the API provides the ability for API tokens to write comments on behalf of other actors.
        - `id` string, nullable — An ID to identify the actor.
        - `type` 'api-token' | 'workspace-member' | 'system' | 'app', nullable — The type of actor. [Read more information on actor types here](/docs/actors).
    - `created_at` string, required — When the thread was created.

---

[API](https://skmtc.net/d-stoll/apis/attio-api.md) · [All operations](https://skmtc.net/d-stoll/apis/attio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/d-stoll/attio-api/versions/ebcf9b5c6aa3/schema)