# Find thread

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

`GET /v2/api/threads`

<Note>
**Required scope:** `THREADS_READ`
</Note>

## Behavior

Looks up the thread attached to a conversation item. Pass the item's type as `entity_type` (`CALL`, `TEXT_MESSAGE`, or `CONVERSATION_NOTE`) and its ID as `entity_id` (`cll-*`, `msg-*`, or `not-*`).

Since each item has at most one thread, `data` contains either zero or one thread. An empty `data` array means the item exists but has no thread yet — create one with [`POST /v2/api/threads`](/docs/threads/create-thread).

## Errors

| Status | Code | When |
|--------|------|------|
| `400` | `INVALID_THREAD_ENTITY_TYPE` | `entity_type` is not one of `CALL`, `TEXT_MESSAGE`, `CONVERSATION_NOTE` |
| `404` | `CONVERSATION_ITEM_NOT_FOUND` | No conversation item with this `entity_id` |
