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

# List Threads

`GET /v1/threads`

## Request

- Base URL: `https://api.claims.zicron.ai`
- URL: `https://api.claims.zicron.ai/v1/threads`
- Auth: none declared

List threads, grouped by thread_id, ordered by most recent activity.

## Query parameters

- `person_id` string, nullable
- `claim_id` string, nullable
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- ThreadSummary[]
  - `thread_id` string, required
  - `person_id` string, nullable
  - `person_name` string, nullable
  - `channels_used` string[]
  - `claim_ids` string[]
  - `claim_types` string[]
  - `last_activity_at` string, nullable
  - `last_message_preview` string, nullable
  - `active_status` string, required
  - `conversation_count` integer, required
  - `unread_count` integer
  - `summary` string, nullable
  - `pinned_facts` object
  - `status` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zicron/apis/zicron-api.md) · [All operations](https://skmtc.dev/zicron/apis/zicron-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zicron/apis/zicron-api/revisions/abe62e22aa46?raw)