> ## Documentation Index
> Fetch the complete documentation index at: https://docs.decodahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Notifications

> Get notifications for the current provider with cursor-based pagination



## OpenAPI

````yaml get /notifications
openapi: 3.1.0
info:
  title: Decoda API
  description: External API documentation for the Decoda Health platform.
  version: '1.0'
servers: []
security: []
paths:
  /notifications:
    get:
      tags:
        - provider
        - notifications
      summary: Get Notifications
      description: Get notifications for the current provider with cursor-based pagination
      operationId: get_notifications_notifications_get
      parameters:
        - name: TENANT
          in: header
          required: true
          schema:
            type: string
            title: Tenant
          description: The tenant you are making this request on behalf of
        - name: API-KEY
          in: header
          required: true
          schema:
            type: string
            title: Api-Key
          description: Your api key
        - name: alert_type
          in: query
          required: false
          schema:
            anyOf:
              - items:
                  type: string
                type: array
              - type: 'null'
            description: Filter by alert types
            title: Alert Type
          description: Filter by alert types
        - name: per_page
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            default: 20
            title: Per Page
        - name: cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Cursor
        - name: read
          in: query
          required: false
          schema:
            anyOf:
              - type: boolean
              - type: 'null'
            title: Read
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotificationCursorPage'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    NotificationCursorPage:
      properties:
        data:
          items:
            $ref: '#/components/schemas/ProviderNotificationSummary'
          type: array
          title: Data
        unreadCount:
          anyOf:
            - type: integer
            - type: 'null'
          title: Unreadcount
        nextCursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Nextcursor
      type: object
      required:
        - data
      title: NotificationCursorPage
      description: Cursor-paginated notification response with unread count metadata
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ProviderNotificationSummary:
      properties:
        id:
          type: string
          title: Id
        read:
          type: boolean
          title: Read
        createdDate:
          type: string
          format: date-time
          title: Createddate
        alert:
          $ref: '#/components/schemas/NotificationAlertSummary'
      type: object
      required:
        - id
        - read
        - createdDate
        - alert
      title: ProviderNotificationSummary
      description: Summary of a provider notification for list views
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    NotificationAlertSummary:
      properties:
        type:
          $ref: '#/components/schemas/AlertType'
        content:
          type: string
          title: Content
          default: ''
      type: object
      required:
        - type
      title: NotificationAlertSummary
      description: |-
        Lightweight alert info for notification list views.

        Only the fields the notification UI actually needs — avoids validating
        the full alert data payload which varies by alert type.
    AlertType:
      type: string
      enum:
        - PATIENT_CREATED
        - PATIENT_UPDATED
        - APPOINTMENT_CANCELLED
        - APPOINTMENT_UPDATED
        - APPOINTMENT_REQUEST
        - APPOINTMENT_SCHEDULED
        - SELF_SCHEDULED_APPOINTMENT
        - SELF_SCHEDULED_APPOINTMENT_CANCELLED
        - SELF_SCHEDULED_APPOINTMENT_UPDATED
        - BLOCK_CREATED
        - BLOCK_CANCELLED
        - BLOCK_UPDATED
        - SHIFT_CREATED
        - SHIFT_CANCELLED
        - SHIFT_UPDATED
        - PAYMENT_CREATED
        - PAYMENT_FAILED
        - PAYMENT_SUCCEEDED
        - PLANNED_PAYMENT_FAILED
        - PLANNED_PAYMENT_SUCCEEDED
        - CHARGE_CREATED
        - REFUND_CREATED
        - REFUND_FAILED
        - REFUND_SUCCEEDED
        - ADJUSTMENT_CREATED
        - ADJUSTMENT_FAILED
        - ADJUSTMENT_SUCCEEDED
        - INVOICE_UPDATED
        - INVOICE_STATUS_UPDATE
        - INVOICE_SET_UPDATED
        - CHARGE_PAYMENT_CREATED
        - CALL_RECEIVED
        - CALL_MADE
        - MESSAGE_RECEIVED
        - MESSAGE_SENT
        - MESSAGE_DELIVERED
        - MESSAGE_FAILED
        - EMAIL_RECEIVED
        - EMAIL_SENT
        - MAIL_SENT
        - MAIL_DELIVERY_FAILED
        - FORM_SUBMITTED
        - APPOINTMENT_CHECKLIST_FILLED_FORM
        - APPOINTMENT_CHECKLIST_CHECKED_IN
        - APPOINTMENT_CHECKLIST_WITH_MA
        - APPOINTMENT_CHECKLIST_MEASUREMENT_TAKEN
        - APPOINTMENT_CHECKLIST_DOSE_TAKEN
        - APPOINTMENT_CHECKLIST_WITH_PROVIDER
        - APPOINTMENT_CHECKLIST_NOTE_TAKEN
        - APPOINTMENT_CHECKLIST_PAYMENT_MADE
        - APPOINTMENT_CHECKLIST_REQUEST_GFE
        - APPOINTMENT_CHECKLIST_PICTURE_TAKEN
        - APPOINTMENT_CHECKLIST_CARE_PLAN
        - NOTIFICATION
        - LOW_PATIENT_REVIEW
        - RAINFOREST_DEPOSIT_IN_REVIEW
        - RAINFOREST_DEPOSIT_SUCCEEDED
        - RAINFOREST_DEPOSIT_FAILED
        - CHAT_UPDATE
        - RAINFOREST_PAYIN_FAILED
        - RAINFOREST_PAYIN_PROCESSING
        - RAINFOREST_POS_PAYIN_CANCELLED
        - STOCK_LOW
        - STOCK_ADDED
        - STOCK_ARCHIVED
        - STOCK_LINKED_TO_ITEM
        - STOCK_UNLINKED_FROM_ITEM
        - STOCK_UPDATED
        - STOCK_DRAWDOWN
        - STOCK_PARTIAL_DRAWDOWN
        - SHIPMENT_RECEIVED
        - SHIPMENT_UPDATED
        - SHIPMENT_ARCHIVED
        - ITEM_CREATED
        - ITEM_UPDATED
        - ITEM_ARCHIVED
        - SUPPLIER_LINKED_TO_STOCK
        - SUPPLIER_UNLINKED_FROM_STOCK
        - SUPPLIER_TO_STOCK_UPDATED
        - PO_CREATED
        - PO_PLACED
        - PO_CANCELLED
        - PO_COMPLETED
        - PO_ARCHIVED
        - INVENTORY_ACTION
        - NOTE_CREATED
        - NOTE_UPDATED
      title: AlertType

````