# Get list of notes

Retrieve a paginated list of clinical notes.
Supports filtering by date range and email address.
Results are sorted by creation date in descending order.

Endpoint: GET /notes
Version: 1.0.0
Security: BearerAuth

## Query parameters:

  - `limit` (integer)
    Number of notes to return per page
    Example: 10

  - `offset` (integer)
    Number of notes to skip for pagination

  - `from` (string)
    Start date for filtering notes (inclusive)
    Example: "2025-09-01"

  - `to` (string)
    End date for filtering notes (inclusive)
    Example: "2025-09-11"

  - `email` (string)
    Filter notes by associated email address
    Example: "doctor@playbackhealth.com"

  - `patientId` (string)
    Filter notes by patient identifier (e.g., MRN, EPIC ID, or your internal patient ID).
This should match the identifier used when creating the note.
    Example: "MRN123456"

## Response 200 fields (application/json):

  - `success` (boolean, required)
    Example: true

  - `data` (array, required)
    Example: [{"noteId":"550e8400-e29b-41d4-a716-446655440000","titleText":"Patient Follow-up Notes","createdAt":"2025-09-11T10:00:00Z","email":"doctor@playbackhealth.com"},{"noteId":"660e8400-e29b-41d4-a716-446655440001","titleText":"Initial Consultation","createdAt":"2025-09-10T15:30:00Z","email":"doctor@playbackhealth.com"}]

  - `data.noteId` (string, required)
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `data.titleText` (string, required)
    Example: "Patient Follow-up Notes"

  - `data.createdAt` (string, required)
    Example: "2025-09-11T10:00:00Z"

  - `data.email` (string, required)
    Example: "doctor@playbackhealth.com"

  - `data.patientId` (string)
    Patient identifier (e.g., MRN, EPIC ID, or your internal patient ID).
This matches the identifier used when creating the note.
    Example: "MRN123456"

  - `pagination` (object, required)
    Example: {"limit":10,"offset":0,"total":45}

  - `pagination.limit` (integer, required)
    Example: 10

  - `pagination.offset` (integer, required)

  - `pagination.total` (integer, required)
    Example: 45

## Response 401 fields (application/json):

  - `success` (boolean, required)

  - `message` (string, required)
    Example: "You are not authorized to perform this operation"