---
title: "Get Notes"
method: GET
path: "/notes/list"
tags: ["provider", "scribe", "note"]
---

# Get Notes

`GET /notes/list`

## Query parameters

- `page` integer, nullable
- `per_page` integer, nullable
- `sort_by` string, nullable
- `sort_direction` 'asc' | 'desc', nullable
- `location_id` string, nullable
- `provider_id` string, nullable
- `patient_id` string, nullable
- `note_id` string, nullable
- `patient_name` string, nullable
- `created_date` string[], nullable
- `tz` string, nullable
- `template_id` string, nullable
- `location_ids` string[], nullable

## Headers

- `TENANT` string, required
- `API-KEY` string, required

## Response `200`

Successful Response

- PageNoteListItem
  - `data` NoteListItem[], required
    - `id` string, required
    - `content` string, nullable
    - `summary` string, nullable
    - `templateId` string, nullable
    - `createdDate` string, date-time, required
    - `visitDate` string, date-time, required
    - `lastEditedDate` string, date-time, required
    - `aiGenerated` boolean, required
    - `patient` PatientSummary, required
      - `id` string, required — The unique identifier for the user.
      - `firstName` string, nullable — The user's first name.
      - `lastName` string, nullable — The user's last name.
      - `phoneNumber` string, nullable — The user's phone number.
      - `email` string, nullable — The user's email address.
      - `type` 'PROVIDER' | 'PATIENT' | 'ASSISTANT', required
      - `locationId` string, nullable — The location of the user.
      - `externalId` string, nullable — The user's external identifier if available.
      - `address` string, nullable — The user's primary address.
      - `addressLineTwo` string, nullable — Additional address information.
      - `city` string, nullable — The city of the user's address.
      - `state` string, nullable — The state of the user's address.
      - `zipCode` string, nullable — The postal code of the user's address.
      - `country` string, nullable — The country of the user's address.
      - `createdDate` string, date-time, required — The date and time when the user was created.
      - `addressValid` boolean, nullable — Whether the user's address is valid.
      - `meta` object, nullable — Any additional metadata about the user relevant to your system.
      - `isArchived` boolean, nullable — Whether the user is archived.
      - `primaryLocationId` string, nullable — The primary location of the user.
      - `gender` string, nullable — The gender of the patient.
      - `dateOfBirth` string, date, nullable — The date of birth of the patient.
      - `patientMedications` string[], nullable — List of patient's self-reported medications.
      - `onSchedulingBlacklist` boolean, nullable — Whether the patient is on the scheduling blacklist.
      - `surchargeDisabled` boolean, nullable — Whether surcharges are disabled for this patient.
      - `tags` PatientTagSummary[], nullable — List of patient tags
        - `id` string, required — Unique identifier for the patient tag
        - `name` string, required — Name of the patient tag
        - `emoji` string, nullable — Emoji associated with the tag
        - `color` string, nullable — Color code for the tag (hex format)
        - `isActive` boolean, required — Whether the tag is active
        - `createdDate` string, date-time, required — Date and time when the tag was created
        - `updatedDate` string, date-time, nullable — Date and time when the tag was last updated
      - `creditBalance` integer, nullable — Patient's credit balance in cents.
      - `preferredProviderId` string, nullable — The preferred provider ID for this patient.
    - `providers` ProviderTiny[]
      - `id` string, required
      - `firstName` string, required
      - `lastName` string, nullable
      - `email` string, nullable
      - `createdDate` string, date-time, nullable
    - `version` integer, required
    - `sourceDocuments` DocumentSummary[]
      - `id` string, required
      - `patientId` string, required
      - `filePath` string, required
      - `fileType` string, required
      - `title` string, required
      - `summary` string, nullable, required
      - `docType` 'LAB' | 'PHARMACY' | 'IMAGE' | 'REPORT' | 'OTHER' | 'CONSENT' | 'NOTE_UPLOAD', required
      - `signatureUrl` string, nullable, required
    - `signedOffProviderId` string, nullable
    - `signedOffDate` string, date-time, nullable
  - `total` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/decodahealth/apis/decoda-api.md) · [All operations](https://skmtc.dev/decodahealth/apis/decoda-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decodahealth/decoda-api/revisions/4939a65a89d2/schema)