> ## Documentation Index > Fetch the complete documentation index at: https://developer.vetcove.com/llms.txt > Use this file to discover all available pages before exploring further. # List patient notes > 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). ## OpenAPI ````yaml get /ext/v2/patient-notes/ openapi: 3.1.0 info: description: '' title: NinjaAPI version: 2.0.0 servers: - url: https://connect.vetcove.com/ security: [] paths: /ext/v2/patient-notes/: get: tags: - Clients And Patients summary: List patient notes description: >- 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). operationId: patient_notes_list parameters: - description: When provided, filters to objects with these IDs. in: query name: ids required: false schema: anyOf: - items: type: integer type: array - type: 'null' description: When provided, filters to objects with these IDs. title: Ids - description: >- 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`. in: query name: ending_before required: false schema: anyOf: - type: integer - type: 'null' description: >- 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`. title: Ending Before - description: >- 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`. in: query name: starting_after required: false schema: anyOf: - type: integer - type: 'null' description: >- 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`. title: Starting After - description: The maximum number of items to return per page. in: query name: limit required: false schema: default: 10 description: The maximum number of items to return per page. maximum: 100 minimum: 1 title: Limit type: integer - description: >- 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. in: query name: is_deleted required: false schema: allOf: - enum: - 'FALSE' - 'TRUE' - ALL title: DeletedFilterOption type: string default: 'FALSE' description: >- 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. - description: Filters to patient notes for the clinic patient with the given ID. in: query name: clinic_patient_id required: false schema: anyOf: - type: integer - type: 'null' description: Filters to patient notes for the clinic patient with the given ID. title: Clinic Patient Id responses: '200': content: application/json: schema: $ref: '#/components/schemas/ExternalPatientNoteSchemaList' description: OK security: - ExternalAPIAuth: [] components: schemas: ExternalPatientNoteSchemaList: properties: data: description: A single page of data contained within this list. items: $ref: '#/components/schemas/ExternalPatientNoteSchema' title: Data type: array has_more: default: false description: Whether there are more pages or data in this list. title: Has More type: boolean next_page: description: A URL linking to the next page of this list. title: Next Page type: string type: default: list description: Type of this object. Always `list`. title: Type type: string required: - data - next_page title: ExternalPatientNoteSchemaList type: object ExternalPatientNoteSchema: properties: clinic_patient_id: description: The ID of the clinic patient this note is associated with title: Clinic Patient Id type: integer created_by_name: anyOf: - type: string - type: 'null' description: The full name of the user who created this note title: Created By Name date: description: The date and time when the note was created format: date-time title: Date type: string deleted: anyOf: - format: date-time type: string - type: 'null' description: The datetime this record was soft deleted. title: Deleted details: anyOf: - items: type: object type: array - type: 'null' description: Additional details about the note in JSON format title: Details id: description: The unique identifier for the patient note title: Id type: integer is_deleted: description: Whether this record is soft deleted or not. title: Is Deleted type: boolean is_internal: description: Whether this note is internal or visible to clients title: Is Internal type: boolean is_locked: description: Whether this note is locked and cannot be modified title: Is Locked type: boolean kind: anyOf: - $ref: '#/components/schemas/PatientNoteKind' - const: '' type: string description: The kind of patient note title: Kind required: - is_deleted - deleted - id - clinic_patient_id - kind - is_internal - is_locked - details - date title: ExternalPatientNoteSchema type: object PatientNoteKind: enum: - GENERAL - COMMUNICATION - DOCUMENTATION title: PatientNoteKind type: string securitySchemes: ExternalAPIAuth: scheme: bearer type: http ````