---
title: "채팅방 목록 조회"
method: GET
path: "/api/v3/shopping-fep/business-chat/rooms"
tags: ["비즈니스 채팅"]
---

# 채팅방 목록 조회

`GET /api/v3/shopping-fep/business-chat/rooms`

채팅방 목록을 조회합니다.

## 필터

- `ALL`: 전체 채팅방

- `UNREAD`: 읽지 않은 메시지가 있는 채팅방

- `UNANSWERED`: 진행 중인 세션이 있는 채팅방 (셀러가 답변하지 않은 상태가 아닌, 세션이 on-going인 상태)

## 페이징

- `page` 파라미터를 사용한 offset 페이징을 지원합니다.

- `size`는 최대 100까지 지정할 수 있습니다. (기본값: 20)

## Query parameters

- `filter` 'ALL' | 'UNREAD' | 'UNANSWERED'
- `page` integer
- `size` integer
- `partnerName` string

## Response `200`

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

- object
  - `resultType` 'SUCCESS' | 'FAIL' — 응답 결과 타입
  - `error` object — 에러 응답, resultType FAIL 시 제공
    - `errorCode` 'INVALID_REQUEST' | 'REQUEST_FAILED' | 'COMMON_ERROR' — 에러 코드
    - `reason` string — 에러 사유
  - `success` BusinessChatRoomsFepResponse
    - `rooms` BusinessChatRoomSummaryFepResponse[], required — 채팅방 목록
      - `roomId` integer, required — 채팅방 ID
      - `receiver` ReceiverFepResponse, required — 수신자 정보
        - `type` string, required — 수신자 유형
        - `tossUserNo` integer, required — 토스 사용자 번호
        - `name` string, required — 수신자 이름
        - `profileImageUrl` string — 프로필 이미지 URL
      - `lastMessage` LastMessageFepResponse — 마지막 메시지
        - `messageId` integer, required — 메시지 ID
        - `content` string, required — 메시지 내용
        - `senderType` string, required — 발신자 유형
        - `sentAt` string, date-time, required — 발신 시각
        - `isRead` boolean, required — 읽음 여부
      - `unreadCount` integer, required — 읽지 않은 메시지 수
      - `sessionStatus` string, required — 세션 상태 (ACTIVE: 문의 진행 중, CLOSED: 문의 완료)
      - `lastSession` SessionFepResponse, required — 마지막 세션 정보
        - `sessionId` integer, required — 세션 ID
        - `status` string, required — 세션 상태 (ACTIVE: 문의 진행 중, CLOSED: 문의 완료)
        - `startedAt` string, date-time, required — 세션 시작 시각
        - `endedAt` string, date-time — 세션 종료 시각
        - `startCard` StartCardFepResponse — 시작 카드 정보
          - `chatEntryRefId` integer — 채팅 진입 참조 ID
          - `inquiryType` 'PRODUCT' | 'DELIVERY' | 'EXCHANGE' | 'RETURN' | 'CANCEL' | 'OTHER' — 문의 유형
          - `entryRefType` 'PRODUCT' | 'ORDER_PRODUCT' — 진입 참조 유형
          - `entryRefIds` object — 진입 참조 ID 목록
          - `renderInfo` RenderInfoFepResponse — 렌더링 정보
            - `thumbnail` string — 썸네일 URL
            - `link` string — 링크 URL
            - `title` string — 제목
            - `subtitle` string — 부제목
            - `badge` string — 배지
    - `hasNext` boolean, required — 다음 페이지 존재 여부

---

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