---
title: "브랜드 메시지 템플릿 목록 조회"
method: GET
path: "/v2/messages/kakao/send-profiles/{sendProfileId}/brand-message-templates"
tags: ["Kakao"]
---

# 브랜드 메시지 템플릿 목록 조회

`GET /v2/messages/kakao/send-profiles/{sendProfileId}/brand-message-templates`

## Request

- Base URL: `https://api.sendon.io`
- URL: `https://api.sendon.io/v2/messages/kakao/send-profiles/{sendProfileId}/brand-message-templates`
- Auth: HTTP basic

브랜드 메시지 템플릿 목록을 조회합니다. 템플릿 타입과 상태로 필터링하고 커서 기반 페이지 구성을 지원합니다.

## Path parameters

- `sendProfileId` string, required

## Query parameters

- `cursor` string
- `limit` number, nullable
- `status` 'PENDING' | 'APPROVED' | 'REJECTED'
- `messageType` 'BMT' | 'BMI' | 'BMW' | 'BMWL' | 'BMCF'

## Response `200`

목록 조회 결과입니다. 오류가 발생해도 HTTP 200으로 응답하므로, 실패 시 본문의 code와 errorCode를 확인하세요.

- BrandMessageTemplateListResponseDto
  - `code` number, required: HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.
  - `message` string, required: API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "OK", 실패 시 구체적인 오류 사유가 포함됩니다.
  - `data` BrandMessageTemplateListData, required
    - `list` BrandMessageTemplateDto[], required: 조회된 템플릿 목록입니다.
      - `templateId` string, required: 템플릿의 고유 ID입니다.
      - `templateCode` string, required: 카카오에서 부여하는 템플릿 코드입니다.
      - `templateName` string, required: 템플릿의 이름입니다. 관리용으로 사용합니다.
      - `messageType` 'BMT' | 'BMI' | 'BMW' | 'BMWL' | 'BMCF', required: 브랜드메시지 타입입니다. - BMT: 텍스트형 (Brand Message Text) - BMI: 이미지형 (Brand Message Image) - BMW: 와이드형 (Brand Message Wide) - BMWL: 와이드 아이템리스트형 (Brand Message Wide List) - BMCF: 캐러셀 피드형 (Brand Message Carousel Feed)
      - `status` 'PENDING' | 'APPROVED' | 'REJECTED', required: 템플릿 상태 - PENDING: 검수 대기 - APPROVED: 승인 - REJECTED: 반려
      - `rejectionReason` BrandMessageTemplateRejectionReasonDto
        - `code` string, required: 반려 사유를 나타내는 코드입니다.
        - `message` string, required: 반려 사유를 설명하는 문장입니다.
        - `suggestion` string: 수정에 대한 제안 사항입니다.
      - `fallback` BrandMessageFallbackDto
        - `senderNumber` string, required: 발신자 번호입니다.
        - `type` 'SMS' | 'LMS' | 'MMS', required: 대체 발송 타입입니다. - SMS: 단문 메시지 (90바이트) - LMS: 장문 메시지 (2000바이트) - MMS: 멀티미디어 메시지 (이미지 포함)
        - `message` string, nullable, required: 메시지 내용입니다.
        - `title` string, nullable: LMS 또는 MMS로 발송할 때 사용하는 메시지 제목입니다.
        - `images` string[], nullable: MMS로 전송할 때 사용할 이미지 URL 목록입니다.
        - `isAd` boolean: 대체문자를 광고로 발송할지 여부입니다.
        - `groupId` string, nullable: 대체 발송이 요청되었을 때 할당되는 그룹 ID입니다.
      - `createdAt` string, date-time, required: 템플릿이 생성된 시각입니다. ISO 8601 형식입니다.
      - `updatedAt` string, date-time, required: 템플릿이 마지막으로 수정된 시각입니다. ISO 8601 형식입니다.
      - `approvedAt` string, date-time: 템플릿이 승인된 시각입니다. ISO 8601 형식입니다.
    - `totalCount` number, required: 조회된 데이터의 총 개수입니다.

## Changes

- **2026-11-03** `71dc377792d9`: 3 breaking, 7 info
  - the `data` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/list` from the response with the `200` status
  - removed the required property `data/totalCount` from the response with the `200` status
  - api operation id `getBrandMessageTemplates` removed and replaced with `BrandMessageTemplateController_getBrandMessageTemplates`
  - …6 more

[Operation history](https://skmtc.dev/sendon/apis/sendon-api/changes/v2/messages/kakao/send-profiles/:sendProfileId/brand-message-templates/get.md)

---

[API](https://skmtc.dev/sendon/apis/sendon-api.md) - [All operations](https://skmtc.dev/sendon/apis/sendon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sendon/apis/sendon-api/revisions/71dc377792d9?raw)