---
title: "채널 목록 조회"
method: GET
path: "/v2/messages/kakao/send-profiles"
tags: ["Kakao"]
---

# 채널 목록 조회

`GET /v2/messages/kakao/send-profiles`

등록된 채널들의 목록을 페이징 방식으로 조회합니다. 알림톡과 브랜드메시지 발송에 사용할 수 있는 채널들을 확인할 수 있습니다.

## Query parameters

- `limit` number, nullable
- `cursor` string

## Response `200`

채널 목록 조회 요청의 처리 결과입니다. 등록된 채널들의 정보와 페이징 정보가 포함됩니다.

- object — 채널 목록 조회 요청의 처리 결과입니다. 등록된 채널들의 정보와 페이징 정보가 포함됩니다.
  - `code` number — 응답 코드
  - `message` string — 응답 메시지
  - `data` object, required
    - `sendProfiles` object[], required — 조회된 채널(발신프로필)들의 목록입니다. 각 채널의 상세 정보가 포함됩니다.
      - `id` string, required — 채널의 고유 ID입니다. 시스템 내부에서 채널을 식별하는 데 사용됩니다.
      - `channelId` string, required — 카카오톡 채널 ID입니다. @로 시작하는 카카오톡 채널 ID입니다.
      - `channelName` string, required — 채널의 표시 이름입니다. 사용자에게 메시지 수신 시 표시되는 이름입니다.
      - `status` 'ACTIVE' | 'SUSPENDED' | 'DELETED', required — 채널 상태 - ACTIVE: 활성화 상태 - 메시지 발송 가능 - SUSPENDED: 일시 정지 상태 - DELETED: 삭제됨
      - `profileStatus` 'ACTIVATED' | 'DEACTIVATED' | 'BLOCKED' | 'DELETING' | 'DELETED', required — 카카오톡 채널 상태 - ACTIVATED: 활성화됨 - DEACTIVATED: 비활성화됨 - BLOCKED: 차단됨 - DELETING: 삭제 진행 중 - DELETED: 삭제됨
      - `dormant` boolean, required — 채널(발신프로필)의 휴면 상태 여부입니다. true인 경우 일정 기간 사용하지 않아 휴면 상태로 전환되었음을 의미합니다.
      - `block` boolean, required — 채널(발신프로필)의 차단 상태 여부입니다. true인 경우 정책 위반 등으로 차단된 상태입니다.
      - `updatedBy` string, nullable, required — 채널(발신프로필)을 마지막으로 수정한 사용자의 ID입니다.
      - `updatedAt` string, date-time, nullable, required — 채널(발신프로필) 정보가 마지막으로 수정된 날짜와 시간입니다. ISO 8601 형식으로 표시됩니다.
      - `createdAt` string, date-time, nullable, required — 채널(발신프로필)이 생성된 날짜와 시간입니다. ISO 8601 형식으로 표시됩니다.
    - `nextCursor` string, nullable, required — 다음 페이지 조회를 위한 커서 값입니다.

---

[API](https://skmtc.net/sendon/apis/sendon-api.md) · [All operations](https://skmtc.net/sendon/apis/sendon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendon/sendon-api/versions/525dedc81a05/schema)