긴급알림 목록 조회 – Kakao Shopping Open API

긴급알림 목록을 조회합니다.

카카오쇼핑 고객센터에서 판매자에게 전달한 긴급알림 내역을 조회합니다.
등록일 또는 처리완료일 기준으로 조회 가능하며, 비노출 처리된 긴급알림(displayYn = N)은 모든 조회에서 제외됩니다.

1. 기본 정보

메서드	URL
GET	`/v1/shopping/bizseller/emergency-article`

2. 요청 (파라미터)

필드명	타입	필수여부	설명
pageNo	Integer	선택	요청 페이지 번호 (1-base) - 기본값 1 - 1 미만이면 400 반환
size	Integer	선택	요청 페이지 크기 - 기본값 20, 최소 20, 최대 50 - 범위 밖이면 400 반환
searchDateType	String	필수	조회 기간 기준일 - CREATED_AT(등록일), COMPLETED_AT(처리완료일) 중 하나
searchStartDate	Date	필수	조회 시작일 (KST 기준, yyyy-MM-dd) - 시작일 00:00:00 부터 포함
searchEndDate	Date	필수	조회 종료일 (KST 기준, yyyy-MM-dd) - 종료일 23:59:59 까지 포함
category1depthId	Long	선택	긴급알림 유형 1depth ID - 해당 ID 자체로 등록된 알림만 매칭하며 산하 2depth(leaf) 알림은 미포함 - categoryId 가 함께 전달되면 categoryId 우선 적용
categoryId	Long	선택	긴급알림 유형 2depth ID (leaf) - 해당 ID 로 등록된 알림만 매칭
status	EmergencyArticleStatus	선택	처리상태 필터 (단일 값만 조회 지원) - UNPROCESSED (미처리) - PROCESSING (처리중) -COMPLETED (처리완료) - CLOSED (종결)
longUnprocessedYn	String	선택	장기 미처리 여부 Y/N - Y 인 경우 status=UNPROCESSED 이며 등록 후 3영업일이 지난 알림만 조회
channelId	Long	선택	판매채널 ID
productId	Long	선택	채널상품번호
searchIdType	String	선택	검색 대상 ID 유형 - ORDER_ID (주문번호) - ARTICLE_ID (긴급알림번호)
searchId	Long	선택	searchIdType 에 해당하는 검색값

3. 응답

표를 필드명 열을 기준으로 올림차순(으)로 정렬했습니다.
목록조회 응답의 contents 는 HTML 제거 후 약 150 byte 로 축약하여 제공됩니다. 전체 내용은 상세 조회 API에서 확인할 수 있습니다. contents 배열 요소는 아래 데이터 타입 > EmergencyArticleSummary 입니다.

필드명	타입	필수여부	설명
contents	Array<EmergencyArticleSummary>	필수	조회된 긴급알림 목록. 없으면 빈 배열
last	boolean	필수	마지막 페이지 여부
totalCount	Long	필수	조회 조건에 해당하는 전체 긴급알림 수

4. 예제

1) 호출

curl -X GET 'https://kapi.kakao.com/v1/shopping/bizseller/emergency-article?pageNo=1&size=20&searchDateType=CREATED_AT&searchStartDate=2026-05-01&searchEndDate=2026-05-18&status=UNPROCESSED' \
  --header 'authorization: KakaoAK {대행사인증키}' \
  --header 'target-authorization: KakaoAK {판매자인증키}' \
  --header 'channel-ids: 1' \
  --header 'Content-type: application/json'

2) 응답

{
  "contents": [
    {
      "articleId": 4686748,
      "sellerName": "테스트",
      "channelName": "선물하기",
      "category1depthId": 1,
      "category1depthName": "공지",
      "categoryId": 7,
      "categoryName": "[장기 미종결 클레임 처리] 교환/반품 처리 지연안내",
      "content": "안녕하세요. 선물하기 입니다. 주문이 반품으로 접수된 뒤, 반품승인 및 보류 처리 되지 않아 반품이 철회됩니다.",
      "status": "UNPROCESSED",
      "longUnprocessedYn": "Y",
      "createdAt": "2026-05-17 08:01:00",
      "modifiedAt": "2026-05-17 08:01:00",
      "articleProductOrderList": [
        {
          "productId": 467527154,
          "productName": "건기식&해외",
          "orderId": 2800549137,
          "optionName": null
        }
      ]
    }
  ],
  "totalCount": 1,
  "last": true
}

3) 응답 에러

HTTP	케이스
400	잘못된 파라미터 - 지원하지 않는 enum 값, 잘못된 date 형식 - searchStartDate > searchEndDate, pageNo < 1, size 범위(20~50) 위반 - longUnprocessedYn 이 Y/N 이외 - searchIdType/searchId 짝 누락 - 필수 파라미터(searchDateType/searchStartDate/searchEndDate) 누락 등
401	인증 실패
500	서버 내부 오류

이 섹션의 문서