> ## Documentation Index
> Fetch the complete documentation index at: https://api-documentation.kare-app.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Counters of the caller inbox, per severity and per state

> Every counter but `unread` covers the whole inbox, read rows included. Two queries: one groupBy on (type, severity) for `total`, `actionRequired` and `bySeverity`, and one aggregate whose non-null counts on `readAt` and `pinnedAt` answer `unread` and `pinned` without a third round trip.



## OpenAPI

````yaml /api/rs/openapi.json get /rs/notifications/v1/summary
openapi: 3.0.3
info:
  title: KARE API
  description: Backend API for the KARE platform
  version: dev
servers:
  - url: http://localhost:3000
    description: Local dev
security: []
tags:
  - name: better-auth
    description: >-
      Better Auth's own endpoints (sign-in, session, MFA, password) - generated
      from the audience's live config via `generateOpenAPISchema()`, not
      hand-written.
paths:
  /rs/notifications/v1/summary:
    get:
      tags:
        - notifications
      summary: Counters of the caller inbox, per severity and per state
      description: >-
        Every counter but `unread` covers the whole inbox, read rows included.
        Two queries: one groupBy on (type, severity) for `total`,
        `actionRequired` and `bySeverity`, and one aggregate whose non-null
        counts on `readAt` and `pinnedAt` answer `unread` and `pinned` without a
        third round trip.
      operationId: getNotificationsSummaryRSV1
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  total:
                    type: integer
                    minimum: 0
                    maximum: 9007199254740991
                  unread:
                    type: integer
                    minimum: 0
                    maximum: 9007199254740991
                  actionRequired:
                    type: integer
                    minimum: 0
                    maximum: 9007199254740991
                  pinned:
                    type: integer
                    minimum: 0
                    maximum: 9007199254740991
                  bySeverity:
                    type: object
                    properties:
                      alert:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      reminder:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      info:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                    required:
                      - alert
                      - reminder
                      - info
                    additionalProperties: false
                required:
                  - total
                  - unread
                  - actionRequired
                  - pinned
                  - bySeverity
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  requestId:
                    type: string
                  details: {}
                required:
                  - error
                  - message
                  - requestId
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  requestId:
                    type: string
                  details: {}
                required:
                  - error
                  - message
                  - requestId
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                  requestId:
                    type: string
                  details: {}
                required:
                  - error
                  - message
                  - requestId
                additionalProperties: false

````