채널 그룹 초대 목록 조회
작성일 2026.03.07 | 수정일 2026.03.07
GET
/kakao/v2/channel-groups/invitationsQuery
invitationId— 초대 ID로 필터링
channelId— 채널 ID로 필터링
channelGroupId— 채널 그룹 ID로 필터링
targetType— 조회 방향 (FROM: 받은 초대, TO: 보낸 초대)
status— 초대 상태로 필터링 (PENDING, REFUSED, ACCEPTED, CANCELED). eq, in 연산자 지원
dateCreated— 생성 일시 필터 (eq, gte, lte, gt, lt 연산자 지원)
dateUpdated— 수정 일시 필터 (eq, gte, lte, gt, lt 연산자 지원)
startKey— 페이지네이션 시작 키
limit— 조회할 항목 수
chat
지원 연사자를 사용하실 경우 Query Operator 가이드를 참조하세요
채널 그룹 초대 목록을 조회합니다. targetType 파라미터로 받은 초대(FROM)와 보낸 초대(TO)를 구분하여 조회할 수 있으며, 상태, 날짜 등의 필터와 커서 기반 페이지네이션을 지원합니다. 초대 관리 대시보드를 구축하거나 대기 중인 초대를 일괄 확인할 때 활용합니다.
Response
Structure
Response
{
"invitationList": [
{
"invitationId": "KA02IG00000001",
"channelGroupId": "KA01GI00000001",
"channelId": "CH01PF003",
"status": "PENDING",
"type": "PRIVATE",
"channelName": "@mychannel",
"channelGroupName": "마케팅 채널 그룹",
"dateCreated": "2024-01-01T00:00:00.000Z",
"dateUpdated": "2024-01-01T00:00:00.000Z"
}
],
"startKey": null
}