---
title: "Find thread"
method: GET
path: "/v2/api/threads"
tags: ["Threads"]
---

# Find thread

`GET /v2/api/threads`

## Request

- Base URL: `https://api.withallo.com`
- URL: `https://api.withallo.com/v2/api/threads`
- Auth: API key in header `Authorization`

Finds the discussion thread attached to a conversation item. Returns zero or one thread — each item has at most one thread.

## Query parameters

- `entity_type` 'CALL' | 'TEXT_MESSAGE' | 'CONVERSATION_NOTE', required
- `entity_id` string, required

## Response `200`

The item's thread, or an empty list if none exists

- object
  - `data` Thread[]
    - `id` string: Thread ID (`cth-*`)
    - `entity_type` 'CALL' | 'TEXT_MESSAGE' | 'CONVERSATION_NOTE': Type of the conversation item the thread is attached to.
    - `entity_id` string: ID of the conversation item (`cll-*`, `msg-*`, or `not-*`).
    - `contact_number` string: The contact's phone number (E.164).
    - `resolved` boolean
    - `resolved_at` string, date-time, nullable
    - `resolved_by` NoteUser: Author of a note or comment.
      - `id` string
      - `name` string, nullable
    - `comment_count` integer
    - `created_at` string, date-time
    - `comments` ThreadComment[]
      - `id` string: Comment ID (`thc-*`)
      - `content` string: Comment text, with mentions inline as `@[Name](usr-...)`.
      - `user` NoteUser: Author of a note or comment.
        - `id` string
        - `name` string, nullable
      - `mentions` NoteMention[]
        - `user_id` string
        - `name` string, nullable
        - `deleted` boolean: `true` if the mentioned user has since been removed from the team.
      - `created_at` string, date-time
      - `updated_at` string, date-time

## Other responses

- `400`: Invalid request parameters
- `401`: Invalid or missing API key
- `404`: Resource not found
- `429`: Rate limit exceeded

## Changes

- **2026-11-03** `46c77103dd14`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withallo/apis/allo-api/changes/v2/api/threads/get.md)

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) - [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withallo/apis/allo-api/revisions/46c77103dd14?raw)