---
title: "Get thread summary"
method: GET
path: "/v1/threads/{threadId}/summary/"
tags: ["/v1/threads"]
---

# Get thread summary

`GET /v1/threads/{threadId}/summary/`

## 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/threads/{threadId}/summary/`
- Auth: HTTP bearer

Generates a patient-friendly summary of a conversation thread. Please contact the support@counselhealth.com for access to this API.

## Path parameters

- `threadId` string, uuid, required

## Headers

- `Idempotency-Key` string

## Response `200`

Default Response

- object
  - `thread_id` string, required
  - `created_at` string, required
  - `last_activity_at` string, required
  - `summary` string, required
  - `mode` 'AI' | 'PHYSICIAN', required
  - `treatment_information` object
    - `diagnosis` string[], required
    - `disposition` string[], required
    - `prescriptions` string[], required
  - `treatment_information_coded` object: Structured diagnosis and prescription entries extracted from the thread's patient notes and prescription orders. Each entry carries a stable `id` intended as an upsert key for downstream EMRs.
    - `diagnosis` object[], required
      - `id` string, uuid, required
      - `code` string, required
      - `code_type` 'icd-10', required
      - `name` string, required
      - `is_primary` boolean, required
      - `created_at` string, date-time, required: datetime in ISO 8601 format
    - `prescriptions` object[], required
      - `id` string, uuid, required
      - `code` string
      - `system` union: FHIR coding system URI paired with `code`. In practice this is RxNorm or NDC.
        - 'http://hl7.org/fhir/sid/ndc' | 'http://www.nlm.nih.gov/research/umls/rxnorm'
        - string
      - `name` string, required
      - `status` 'active' | 'on-hold' | 'cancelled' | 'completed' | 'entered-in-error' | 'stopped' | 'draft' | 'unknown'
      - `authored_on` string, date-time: datetime in ISO 8601 format
      - `route` string
      - `instructions` string
      - `dosage` object[]
        - `text` string
        - `dose` object
          - `value` number
          - `unit` string
        - `route` string
        - `frequency` string
        - `as_needed` boolean
      - `reason` object[]
        - `code` string
        - `system` string: FHIR coding system URI paired with `code`. Reasons are typically ICD-10 coded.
        - `text` string
      - `quantity` number
      - `quantity_unit` union
        - 'Each' | 'Milliliter' | 'Gram' | 'Applicator' | 'Blister' | 'Caplet' | 'Capsule' | 'Film' | 'Gum' | 'Implant' | 'Insert' | 'Kit' | 'Lancet' | 'Lozenge' | 'Packet' | 'Pad' | 'Patch' | 'Pen Needle' | 'Ring' | 'Sponge' | 'Stick' | 'Strip' | 'Suppository' | 'Swab' | 'Tablet' | 'Troche' | 'Unspecified' | 'Vial' | 'Wafer'
        - string
      - `refills` integer
      - `days_supply` integer
      - `allow_substitution` boolean
      - `created_at` string, date-time, required: datetime in ISO 8601 format

## 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)