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

# List inbox notifications

> Get user's notification inbox with optional filtering



## OpenAPI

````yaml api-docs/app-team/notifications.json get /api/v1/notifications/inbox
openapi: 3.1.1
info:
  title: Notification Service API
  version: 1.0.0
  description: >-
    Notification Service API for real-time notifications via Server-Sent Events
    (SSE) for Arc and Atlas applications
servers:
  - url: http://localhost:4055
    description: Local Development
security: []
paths:
  /api/v1/notifications/inbox:
    get:
      tags:
        - Inbox
      summary: List inbox notifications
      description: Get user's notification inbox with optional filtering
      parameters:
        - schema:
            type: string
          required: false
          name: unreadOnly
          in: query
        - schema:
            type: string
          required: false
          name: category
          in: query
        - schema:
            type: string
          required: false
          name: priority
          in: query
        - schema:
            type: string
            enum:
              - user
              - users
              - organization
              - all
            description: >-
              Filter by notification scope: "user" (notifications where current
              user is subject), "users" (all user-scoped notifications),
              "organization" (organization-scoped), "all" (no scope filter)
          required: false
          description: >-
            Filter by notification scope: "user" (notifications where current
            user is subject), "users" (all user-scoped notifications),
            "organization" (organization-scoped), "all" (no scope filter)
          name: scope
          in: query
        - schema:
            type: string
          required: false
          name: limit
          in: query
        - schema:
            type: string
          required: false
          name: cursor
          in: query
        - schema:
            type: string
            enum:
              - arc
              - atlas
            description: >-
              Explicit platform identifier. If provided, overrides
              auto-detection based on session context.
          required: false
          description: >-
            Explicit platform identifier. If provided, overrides auto-detection
            based on session context.
          name: platform
          in: query
      responses:
        '200':
          description: Notification inbox
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        category:
                          type: string
                        priority:
                          type: string
                        title:
                          type: string
                        message:
                          type: string
                        resourceType:
                          type: string
                          nullable: true
                        resourceId:
                          type: string
                          nullable: true
                        actionUrl:
                          type: string
                          nullable: true
                        clickActionUrl:
                          type: string
                          nullable: true
                        primaryActionLabel:
                          type: string
                          nullable: true
                        primaryActionUrl:
                          type: string
                          nullable: true
                        secondaryActionLabel:
                          type: string
                          nullable: true
                        secondaryActionUrl:
                          type: string
                          nullable: true
                        read:
                          type: boolean
                        readAt:
                          type: string
                          nullable: true
                        createdAt:
                          type: string
                      required:
                        - id
                        - category
                        - priority
                        - title
                        - message
                        - resourceType
                        - resourceId
                        - actionUrl
                        - clickActionUrl
                        - primaryActionLabel
                        - primaryActionUrl
                        - secondaryActionLabel
                        - secondaryActionUrl
                        - read
                        - readAt
                        - createdAt
                  meta:
                    type: object
                    properties:
                      requestId:
                        type: string
                      timestamp:
                        type: string
                      pagination:
                        type: object
                        properties:
                          total:
                            type: number
                          pageSize:
                            type: number
                          hasMore:
                            type: boolean
                        required:
                          - total
                          - pageSize
                          - hasMore
                      unreadCount:
                        type: number
                    required:
                      - requestId
                      - timestamp
                      - pagination
                      - unreadCount
                required:
                  - success
                  - data
                  - meta
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      requestId:
                        type: string
                      timestamp:
                        type: string
                    required:
                      - requestId
                      - timestamp
                required:
                  - success
                  - error
                  - meta
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      requestId:
                        type: string
                      timestamp:
                        type: string
                    required:
                      - requestId
                      - timestamp
                required:
                  - success
                  - error
                  - meta

````