---
title: "Get paginated threads for a user"
method: GET
path: "/v1/user/threads/"
tags: ["/v1/end-user-jwt"]
---

# Get paginated threads for a user

`GET /v1/user/threads/`

## Request

- Base URL: `https://api.counselhealth.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.counselhealth.com/v1/user/threads/`
- Auth: HTTP bearer

Returns a paginated list of threads for the user. Supports filtering by thread mode, cursor-based pagination, and ordering by the last activity timestamp.

## Query parameters

- `mode` 'AI' | 'PHYSICIAN'
- `cursor` string

## Headers

- `Idempotency-Key` string

## Response `200`

Default Response

- object
  - `threads` object[], required
    - `id` string, uuid, required
    - `patient_id` string, uuid, required
    - `mode` 'AI' | 'PHYSICIAN', required
    - `display_name` string, nullable, required
    - `module` 'get_advice' | 'order_lab' | 'refill_medication' | 'review_my_results' | 'get_care' | 'lifestyle_conditions' | 'get_care_quickly' | 'symptom_radar' | 'review_lab_results' | 'bp_signals' | 'cycle_insights' | 'cycle_insights_ttc' | 'optimize_lifestyle' | 'get_treatment', nullable, required: The chat module the thread is in. Nullable as chats started with a set of messages may have no module. May change over the life of the thread; a change emits `thread.updated`.
    - `status` 'unclaimed' | 'assigned' | 'active' | 'closed', required
    - `created_at` string, date-time, required
    - `last_activity_time` string, date-time, required
    - `expires_at` string, date-time, nullable, required
    - `updated_at` string, date-time, required
    - `terminated_at` string, date-time, nullable, required
    - `termination_reason` 'emergency' | 'malicious_action', nullable, required
    - `sla_start_at` string, date-time, nullable
    - `metadata` object, nullable: Custom key-value metadata for threads. Max 25 keys, each value ≤ 1800 characters. Keys must be alphanumeric with underscores/hyphens only.
  - `cursor` string

## Other responses

- `400`: 400 error with a machine-readable `code` for client branching.
- `401`: Standard error body returned for non-2xx responses.
- `403`: Standard error body returned for non-2xx responses.
- `404`: Standard error body returned for non-2xx responses.
- `409`: Standard error body returned for non-2xx responses.
- `413`: Standard error body returned for non-2xx responses.
- `429`: Standard error body returned for non-2xx responses.
- `500`: Standard error body returned for non-2xx responses.
- `502`: Default Response
- `503`: Default Response
- `504`: Default Response

---

[API](https://skmtc.dev/counselhealth/apis/counsel-api.md) - [All operations](https://skmtc.dev/counselhealth/apis/counsel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/counselhealth/apis/counsel-api/revisions/4110a89127e8?raw)