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

# 알림 목록 조회

> <p>현재 로그인한 사용자의 알림 목록을 최신순으로 조회합니다. cursor와 limit을 사용해 다음 페이지를 조회할 수 있습니다. 삭제된 알림은 조회되지 않습니다.</p>



## OpenAPI

````yaml /api-docs.json get /api/v1/notifications
openapi: 3.1.0
info:
  title: Polaris API
  version: 0.0.1
servers:
  - url: https://k-polaris.life
    description: Polaris API 서버
security: []
paths:
  /api/v1/notifications:
    get:
      tags:
        - 알림
      summary: 알림 목록 조회
      description: >-
        <p>현재 로그인한 사용자의 알림 목록을 최신순으로 조회합니다. cursor와 limit을 사용해 다음 페이지를 조회할 수
        있습니다. 삭제된 알림은 조회되지 않습니다.</p>
      operationId: getNotifications
      parameters:
        - name: cursor
          in: query
          description: 커서 이후의 알림만 조회하려면 이전 응답의 nextCursor 값을 입력하세요. 없으면 첫 페이지를 조회합니다.
          required: false
          schema:
            type: string
        - name: limit
          in: query
          description: 한 번에 조회할 알림 개수입니다. 1부터 100까지 입력할 수 있으며 기본값은 20입니다.
          required: false
          schema:
            type: integer
            format: int32
            default: 20
      responses:
        '200':
          description: 성공
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: >-
                  #/components/schemas/CursorPageResponseUserNotificationResponse
        '400':
          description: cursor 또는 limit 값이 올바르지 않습니다.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: >-
                  #/components/schemas/CursorPageResponseUserNotificationResponse
        '401':
          description: 인증이 필요합니다.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: >-
                  #/components/schemas/CursorPageResponseUserNotificationResponse
      security:
        - bearerAuth: []
components:
  schemas:
    CursorPageResponseUserNotificationResponse:
      type: object
      properties:
        hasNext:
          type: boolean
          description: 다음 페이지가 있으면 true입니다.
          example: true
        nextCursor:
          type: string
          description: 다음 페이지 조회에 사용할 커서입니다. 다음 페이지가 없으면 null입니다.
          example: 98
        items:
          type: array
          description: 현재 페이지의 항목 목록입니다.
          items:
            $ref: '#/components/schemas/UserNotificationResponse'
    UserNotificationResponse:
      type: object
      properties:
        notificationId:
          type: integer
          format: int64
          description: 알림을 식별하는 ID입니다.
          example: 123
        notificationType:
          type: string
          description: 알림 유형입니다.
          example: BOOK_AVAILABLE
        isbn:
          type: string
          description: 알림 대상 도서를 식별하는 ISBN입니다.
          example: 9791191111111
        bookTitle:
          type: string
          description: 알림 대상 도서명입니다.
          example: 테스트 도서
        libraryId:
          type: integer
          format: int64
          description: 알림 대상 도서관을 식별하는 ID입니다.
          example: 10
        libraryName:
          type: string
          description: 알림 대상 도서관명입니다.
          example: 구미시립양포도서관
        title:
          type: string
          description: 알림 제목입니다.
          example: 대출 가능 알림
        message:
          type: string
          description: 사용자에게 표시할 알림 내용입니다.
          example: 알림 받기 한 도서가 구미시립양포도서관에서 대출 가능합니다.
        notificationDate:
          type: string
          format: date
          description: 알림이 생성된 날짜입니다.
          example: '2026-05-07'
        createdAt:
          type: string
          format: date-time
          description: 알림이 생성된 시각입니다.
          example: '2026-05-07T09:00:01'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.