---
title: "Get a patient note by ID"
method: GET
path: "/v1beta/notes/{noteId}/"
tags: ["/v1beta/notes"]
---

# Get a patient note by ID

`GET /v1beta/notes/{noteId}/`

## 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/v1beta/notes/{noteId}/`
- Auth: HTTP bearer

Retrieves a patient note including its body, a `meta` label for the note format (`SOAP Note`), optional structured diagnosis metadata, and timestamps. The note must belong to a patient within your organization. Pass `withPhysician=true` to include the authoring physician (id, name, email, npi) in the response. This endpoint is in beta and its response shape may still change before promotion to /v1.

## Path parameters

- `noteId` string, uuid, required

## Query parameters

- `withPhysician` boolean

## Headers

- `Idempotency-Key` string

## Response `200`

Default Response

- object
  - `id` string, uuid, required
  - `patient_id` string, uuid, required
  - `physician_id` string, uuid, required
  - `thread_id` string, uuid, nullable, required
  - `content` object, required: The note content and metadata
    - `body` string, required: The full text content of the SOAP note
    - `meta` 'SOAP Note', required: The note format type
    - `metadata` object
      - `diagnosis` object[], nullable, required
        - `code` string, required: The ICD-10 diagnosis code
        - `code_type` 'icd-10', required: The type of diagnosis code
        - `name` string, required: Human-readable diagnosis name
        - `is_primary` boolean, required: Whether this is the primary diagnosis
  - `created_at` string, date-time, required: datetime in ISO 8601 format
  - `physician` object
    - `id` string, uuid, required
    - `first_name` string, required
    - `last_name` string, nullable, required
    - `email` string, required
    - `npi` string, nullable, required

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