Skip to main content
GET
/
notes
/
{noteId}
Get a clinical note by ID
curl --request GET \
  --url https://api.healos.ai/ext-api/v1/notes/{noteId} \
  --header 'X-API-Key: <api-key>'
{
  "data": {
    "id": "9b2d4f6a-1c3e-4a5b-8d7f-0e1a2b3c4d5e",
    "patient_id": "481926357104938271",
    "session_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "note_type": "clinical_visit",
    "specialty": "Cardiology",
    "template_id": "<string>",
    "template_name": "Follow-Up Patient Visit",
    "created_at": "2026-03-15T09:30:00.000Z",
    "updated_at": "2026-03-15T10:00:00.000Z",
    "content": "<string>",
    "problems": [
      "Hypertension"
    ],
    "procedures": [
      "12-lead ECG"
    ],
    "icd10_codes": {},
    "cpt_codes": {},
    "transcript": {
      "text": "<string>",
      "summary": "<string>",
      "title": "Follow-up visit",
      "status": "completed",
      "session_date": "<string>",
      "start_time": "<string>",
      "end_time": "<string>"
    },
    "patient": {
      "id": "481926357104938271",
      "name": "Maria Santos",
      "first_name": "<string>",
      "last_name": "<string>",
      "pronouns": "she/her",
      "date_of_birth": "1985-04-12",
      "gender": "female",
      "email": "<string>",
      "phone": "<string>",
      "mrn": "MRN-00123",
      "client_history": {
        "medical_history": "<string>",
        "family_history": "<string>",
        "social_history": "<string>",
        "previous_treatment": "<string>"
      }
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.healos.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-API-Key
string
header
required

API key obtained from /api/v1/ext-api-keys

Path Parameters

noteId
string
required

Clinical note UUID

Example:

"9b2d4f6a-1c3e-4a5b-8d7f-0e1a2b3c4d5e"

Query Parameters

include
string

Comma-separated embedded blocks: transcript, patient. Defaults to both; pass include= to omit all (note body + codes always returned).

Example:

"transcript,patient"

Response

Note detail

data
object
required