채널 목록 조회
작성일 2026.03.05 | 수정일 2026.03.05
GET
/kakao/v2/channelsQuery
channelId— 채널 ID로 필터링
searchId— 검색용 아이디로 필터링. 지원 연산자: eq, ne, like
phoneNumber— 전화번호로 필터링. 지원 연산자: eq, ne, like
categoryCode— 카테고리 코드로 필터링
isMine— 본인 소유 채널만 조회 여부
dateCreated— 생성일시로 필터링. 지원 연산자: eq, gte, lte, gt, lt
dateUpdated— 수정일시로 필터링. 지원 연산자: eq, gte, lte, gt, lt
startKey— 페이지네이션 시작 키
limit— 조회 건수 제한
chat
지원 연사자를 사용하실 경우 Query Operator 가이드를 참조하세요
현재 계정에 연동된 카카오톡 채널의 목록을 조회합니다.
검색용 아이디, 전화번호, 카테고리 코드 등 다양한 조건으로 필터링할 수 있으며, 페이지네이션을 지원합니다.
채널 관리 화면을 구성하거나 연동된 채널 현황을 파악할 때 사용합니다.
Response
채널 객체의 자세한 사항은 공통 응답 스키마를 참조해주세요.
Structure
Response
{
"channelList": [
{
"channelId": "KA01PF230101000000001",
"searchId": "@example",
"accountId": "AC01000000000001",
"phoneNumber": "01012345678",
"sharedAccountIds": [],
"isBrand": false,
"channelName": "예시 채널",
"dateCreated": "2023-01-01T00:00:00.000Z",
"dateUpdated": "2023-01-01T00:00:00.000Z"
}
]
}