# List notifications

Retrieve a paginated list of notifications for the location. Supports filtering by patient, notification group, type, status, and date range. Each notification tracks email and SMS delivery status independently.

Endpoint: GET /partner/v2/account/{accountId}/location/{locationId}/notification
Version: 2.0
Security: PartnerOAuth

## Query parameters:

  - `patientId` (integer)
    Filter by patient ID

  - `notificationGroupId` (integer)
    Filter by notification group ID

  - `type` (string)
    Filter by notification type (use actual NotificationType enum name)

  - `emailStatus` (string)
    Filter by email delivery status
    Enum: "UNPROCESSED", "PROCESSED_SENT", "PROCESSED_UNSENT"

  - `smsStatus` (string)
    Filter by SMS delivery status
    Enum: "UNPROCESSED", "PROCESSED_SENT", "PROCESSED_UNSENT"

  - `startDate` (string)
    Start of date range for scheduled send time (ISO 8601)
    Example: "2025-01-01T00:00:00Z"

  - `endDate` (string)
    End of date range for scheduled send time (ISO 8601)
    Example: "2025-01-31T23:59:59Z"

  - `cursor` (string)
    Pagination cursor from previous response

  - `limit` (integer)
    Number of results per page (max 100)
    Example: 20

## Path parameters:

  - `accountId` (integer, required)
    Account identifier

  - `locationId` (integer, required)
    Location identifier

## Response 200 fields (application/json):

  - `nextCursor` (string)
    Opaque cursor for fetching the next page. Null if no more results.

  - `notifications` (array)
    List of notifications in this page

  - `notifications.appointmentId` (integer)
    Related appointment ID if applicable
    Example: 111

  - `notifications.createdAt` (string)
    Creation timestamp
    Example: "2025-01-14T14:30:00Z"

  - `notifications.emailProcessedAt` (string)
    When the email was processed
    Example: "2025-01-15T09:00:05Z"

  - `notifications.emailStatus` (string)
    Email delivery status
    Enum: "UNPROCESSED", "PROCESSED_SENT", "PROCESSED_UNSENT"

  - `notifications.formGroupId` (integer)
    Related form group ID if applicable
    Example: 222

  - `notifications.id` (integer)
    Unique notification identifier
    Example: 12345

  - `notifications.patientId` (integer)
    Patient ID who received the notification
    Example: 67890

  - `notifications.scheduledAt` (string)
    When the notification is scheduled to be sent
    Example: "2025-01-15T09:00:00Z"

  - `notifications.smsProcessedAt` (string)
    When the SMS was processed
    Example: "2025-01-15T09:00:05Z"

  - `notifications.smsStatus` (string)
    SMS delivery status
    Enum: "UNPROCESSED", "PROCESSED_SENT", "PROCESSED_UNSENT"

  - `notifications.type` (string)
    Notification type (actual NotificationType enum name)
    Example: "APPOINTMENT_CONFIRMATION"


## Response 400 fields

## Response 401 fields

## Response 403 fields