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

# Get Notifications

> Fetches a list of notifications for the authenticated user.



## OpenAPI

````yaml GET /notifications
openapi: 3.0.1
info:
  title: Notification API
  version: 1.0.0
  description: API for fetching user notifications
servers: []
security: []
paths:
  /notifications:
    get:
      summary: Get Notifications
      description: Fetches a list of notifications for the authenticated user.
      parameters:
        - $ref: '#/components/parameters/X-API-KEY'
        - name: cursor
          in: query
          required: false
          schema:
            type: integer
            format: int64
          description: Cursor for pagination (last ID of the page)
        - name: size
          in: query
          required: false
          schema:
            type: integer
            format: int32
            default: 20
          description: Number of notifications to fetch per page.
      responses:
        '200':
          description: A list of notifications
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        actor:
                          type: object
                          properties:
                            id:
                              type: integer
                              description: User ID.
                            username:
                              type: string
                              description: Username of the user.
                            name:
                              type: string
                              description: Name of the user.
                            image:
                              type: string
                              description: Profile image URL.
                            bio:
                              type: string
                              nullable: true
                              description: Biography of the user.
                            verifiedAt:
                              type: string
                              format: date-time
                              nullable: true
                              description: Verification timestamp if the user is verified.
                        post:
                          type: object
                          nullable: true
                          properties:
                            snowflakeId:
                              type: string
                            id:
                              type: integer
                            content:
                              type: string
                              nullable: true
                            type:
                              type: string
                              enum:
                                - post
                                - quote
                                - reply
                                - repost
                                - mention
                                - follow
                            originalId:
                              type: integer
                              nullable: true
                            parentId:
                              type: integer
                              nullable: true
                            repliesCount:
                              type: integer
                            repostsCount:
                              type: integer
                            reposts:
                              type: array
                              description: List of userIds reposted
                              items:
                                type: integer
                        parent:
                          type: object
                          nullable: true
                          properties:
                            id:
                              type: integer
                            snowflakeId:
                              type: string
                            content:
                              type: string
                              nullable: true
                            userId:
                              type: integer
                            type:
                              type: string
                              enum:
                                - quote
                                - reply
                                - repost
                                - mention
                                - follow
                            createdAt:
                              type: string
                              format: date-time
                        id:
                          type: integer
                        type:
                          type: string
                          enum:
                            - quote
                            - reply
                            - repost
                            - mention
                            - follow
                        createdAt:
                          type: string
                          format: date-time
                        read:
                          type: boolean
                  totalPages:
                    type: integer
        '401':
          description: Unauthorized access
        '500':
          description: Internal server error
      security:
        - bearerAuth: []
components:
  parameters:
    X-API-KEY:
      name: X-API-KEY
      description: API key required for authentication
      in: header
      required: true
      schema:
        type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````