---
title: "List patient notes"
method: GET
path: "/ext/v2/patient-notes/"
tags: ["Clients And Patients"]
---

# List patient notes

`GET /ext/v2/patient-notes/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/patient-notes/`
- Auth: HTTP bearer

Returns a list of patient notes. The notes are sorted by creation date, with the most recent notes appearing first.

**Patient notes** are free-text records attached to a clinic patient's timeline. They can be categorized by kind (e.g., general, communication) and marked as internal (visible only to clinic staff) or external (also visible to pet parents).

## Query parameters

- `ids` integer[], nullable: When provided, filters to objects with these IDs.
- `ending_before` integer, nullable: A cursor used for pagination. Fetches the page of results ending immediately before the object with the given ID. Cannot be used at the same time as `starting_after`.
- `starting_after` integer, nullable: A cursor used for pagination. Fetches the page of results starting immediately after the given ID. Cannot be used at the same time as `ending_before`.
- `limit` integer: The maximum number of items to return per page.
- `is_deleted` 'FALSE' | 'TRUE' | 'ALL': When 'FALSE' (default), filters to non-deleted records only. When 'TRUE', filters to soft-deleted records only. When 'ALL', returns both deleted and non-deleted records.
- `clinic_patient_id` integer, nullable: Filters to patient notes for the clinic patient with the given ID.

## Response `200`

OK

- ExternalPatientNoteSchemaList
  - `data` ExternalPatientNoteSchema[], required: A single page of data contained within this list.
    - `clinic_patient_id` integer, required: The ID of the clinic patient this note is associated with
    - `created_by_name` string, nullable: The full name of the user who created this note
    - `date` string, date-time, required: The date and time when the note was created
    - `deleted` string, date-time, nullable, required: The datetime this record was soft deleted.
    - `details` object[], nullable, required: Additional details about the note in JSON format
    - `id` integer, required: The unique identifier for the patient note
    - `is_deleted` boolean, required: Whether this record is soft deleted or not.
    - `is_internal` boolean, required: Whether this note is internal or visible to clients
    - `is_locked` boolean, required: Whether this note is locked and cannot be modified
    - `kind` union, required: The kind of patient note
      - 'GENERAL' | 'COMMUNICATION' | 'DOCUMENTATION'
      - ''
  - `has_more` boolean: Whether there are more pages or data in this list.
  - `next_page` string, required: A URL linking to the next page of this list.
  - `type` string: Type of this object. Always `list`.

---

[API](https://skmtc.dev/vetcove/apis/ninjaapi.md) - [All operations](https://skmtc.dev/vetcove/apis/ninjaapi/llms.txt) - [OpenAPI document](https://skmtc.dev/vetcove/apis/ninjaapi/revisions/4ceaed956e15?raw)