---
title: "공지사항 리스트"
method: GET
path: "/api/v1/notice"
tags: ["Notice"]
---

# 공지사항 리스트

`GET /api/v1/notice`

## Query parameters

- `category` string
- `searchKeyword` string
- `pageSize` integer, required
- `pageNum` integer, required

## Response `200`

OK

- WinclResponseDataListNotice
  - `code` string
  - `currentPageNum` integer — 현재 페이지 번호
  - `items` Notice[]
    - `category` 'EVENT' | 'GENERAL' | 'MAINTENANCE' — 공지사항 타입
    - `contents` string — 공지사항 콘텐츠
    - `expireTimestamp` integer — 공지사항 만료시간
    - `noticeId` string — 공지사항 아이디
    - `registerTimestamp` integer — 공지사항 등록시간
    - `status` 'ACTIVE' | 'DELETED' | 'INACTIVE' | 'READY' — 공지사항 상태
    - `title` string — 공지사항 타이틀
  - `message` string
  - `pageSize` integer — 페이지당 아이템 개수
  - `sortType` 'AMOUNT_ASC' | 'AMOUNT_DESC' | 'ASC' | 'DESC' | 'NONE' | 'PRICE_ASC' | 'PRICE_DESC' | 'UNIT_PRICE_ASC' | 'UNIT_PRICE_DESC' — 정렬 기준
  - `totalCount` integer — 전체 아이템 개수
  - `totalPages` integer — 전체 페이지 수

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/wincl/apis/wincl-api.md) · [All operations](https://skmtc.net/wincl/apis/wincl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wincl/wincl-api/revisions/662edcbbf2b3/schema)