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

# List Notifications Feed

> Paginated per-user notification feed, newest first.

Backs the NotificationsPanel list. Returns PagedResponse plus unread_count
so the bell badge and "N new" label are always fresh from the same call.



## OpenAPI

````yaml /openapi.json get /v1/me/notifications/feed
openapi: 3.1.0
info:
  description: Causeloop Platform Backend
  title: Causeloop API
  version: 1.0.0
servers: []
security: []
paths:
  /v1/me/notifications/feed:
    get:
      tags:
        - notifications
      summary: List Notifications Feed
      description: >-
        Paginated per-user notification feed, newest first.


        Backs the NotificationsPanel list. Returns PagedResponse plus
        unread_count

        so the bell badge and "N new" label are always fresh from the same call.
      operationId: list_notifications_feed_v1_me_notifications_feed_get
      parameters:
        - description: Page size (max 50)
          in: query
          name: limit
          required: false
          schema:
            default: 20
            description: Page size (max 50)
            maximum: 50
            minimum: 1
            title: Limit
            type: integer
        - in: query
          name: cursor
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Cursor
        - description: Return only unread items
          in: query
          name: unread_only
          required: false
          schema:
            default: false
            description: Return only unread items
            title: Unread Only
            type: boolean
        - description: Prefix filter e.g. 'prediction.'
          in: query
          name: type
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Prefix filter e.g. 'prediction.'
            title: Type
        - description: ISO 8601 — return items created after this
          in: query
          name: since
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: ISO 8601 — return items created after this
            title: Since
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotificationFeedResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - HTTPBearer: []
components:
  schemas:
    NotificationFeedResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/Notification'
          title: Data
          type: array
        page:
          additionalProperties: true
          title: Page
          type: object
        unread_count:
          title: Unread Count
          type: integer
      required:
        - data
        - page
        - unread_count
      title: NotificationFeedResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    Notification:
      properties:
        actor:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Actor
        body:
          title: Body
          type: string
        created_at:
          title: Created At
          type: string
        entity_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Entity Id
        entity_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Entity Type
        id:
          title: Id
          type: string
        link:
          anyOf:
            - type: string
            - type: 'null'
          title: Link
        read:
          default: false
          title: Read
          type: boolean
        read_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Read At
        source:
          anyOf:
            - type: string
            - type: 'null'
          title: Source
        status:
          $ref: '#/components/schemas/NotificationStatus'
        title:
          title: Title
          type: string
        type:
          title: Type
          type: string
      required:
        - id
        - type
        - title
        - body
        - status
        - created_at
      title: Notification
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    NotificationStatus:
      enum:
        - unread
        - read
        - archived
      title: NotificationStatus
      type: string
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http

````