> For the complete documentation index, see [llms.txt](https://apidocs.rcsbizcenter.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.rcsbizcenter.com/rbc-api/template/get_template_list.md).

# 템플릿 목록 조회

## Request

## 브랜드에 등록된 템플릿을 조회합니다.<br>

> 브랜드에 등록된 템플릿을 조회합니다. 템플릿 별 승인 상태를 확인할 수 있습니다.  \
> \
> &#x20; \+ \*\*계정 권한: 마스터, 매니저, 대행사\*\*\
> &#x20; \+ \*\*브랜드 권한: 브랜드 대표운영자, 운영자\*\*\
> &#x20; \+ \*\*지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형), 이미지 템플릿, LMS 템플릿\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.15"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandKey":{"name":"X-RCS-Brandkey","in":"header","schema":{"type":"string","maxLength":18},"description":"maxLength: 18 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다.  \n\n대행사가 해당 브랜드에 대한 권한 여부를 판단하는데 사용됩니다.\n따라서, 대행사 계정으로 브랜드 내 정보를 조회/등록/수정 API 연동 시 Header에 설정되어야 합니다.\n"},"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"},"Offset":{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"시작 offset 번호(default: 0) 입니다."},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":100,"maximum":1000,"default":100},"description":"minimum: 100, maximum: 1000 - 조회 최대 건수(default: 100) 입니다.'\n"}}},"paths":{"/brand/{brandId}/messagebase":{"get":{"summary":"브랜드에 등록된 템플릿을 조회합니다.\n","description":"브랜드에 등록된 템플릿을 조회합니다. 템플릿 별 승인 상태를 확인할 수 있습니다.  \n\n  + **계정 권한: 마스터, 매니저, 대행사**\n  + **브랜드 권한: 브랜드 대표운영자, 운영자**\n  + **지원 범위: 텍스트 템플릿(타이틀 선택형 / 타이틀 자유형), 이미지 템플릿, LMS 템플릿**\n","parameters":[{"$ref":"#/components/parameters/BrandKey"},{"$ref":"#/components/parameters/BrandId"},{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>Messagebase 기본 정보입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr><tr><td><a href="#pagination-object"><mark style="color:blue;"><strong><code>pagination</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>전체 건수와 페이징 조건을 제공합니다.</td></tr><tr><td><a href="#links-object"><mark style="color:blue;"><strong><code>links</code></strong></mark></a></td><td>object</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음 페이지 링크를 제공합니다. offset을 0이 아닌 limit보다 작은 양수값으로 설정한 경우 prev 는 null로 응답됩니다.</td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="208">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>groupId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿이 대량등록된 경우 그룹ID 입니다.</td></tr><tr><td><strong><code>messagebaseId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 ID</td></tr><tr><td><strong><code>tmpltName</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 등록시 입력된 템플릿 명칭입니다.</td></tr><tr><td><strong><code>messagebaseformId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿의 원형인 템플릿 양식 ID 입니다.</td></tr><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿이 등록되어 있는 브랜드 ID 입니다. 공통으로 사용하는 템플릿인 경우 'common'으로 표시됩니다.</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>템플릿의 상태를 표시합니다.</p><ul><li>ready : 사용</li><li>pause : 사용중지</li></ul></td></tr><tr><td><strong><code>approvalResult</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td><p>템플릿의 승인 상태입니다.</p><ul><li>저장 : RCS Biz Center 홈페이지에서 템플릿 정보를 입력하고 승인요청 하지 않고 저장해 둔 상태입니다. 저장 상태의 템플릿은 승인요청을 해야 승인대기 상태로 변경됩니다.</li><li>승인대기 : 템플릿 등록 직후 검수 이전 상태입니다.</li><li>검수시작 : 템플릿 검수가 시작된 상태입니다.</li><li>승인 : 검수가 완료되어 이통3사에 정보 등록까지 최종 완료되어 RCS 메시지를 발송할 수 있는 상태입니다.</li><li>반려 : 검수 시 승인이 불가하여 반려된 상태입니다. 반려된 템플릿은 수정 후 다시 승인요청 할 수 있습니다.</li><li>검수완료 : RCS Biz Center에서 검수 승인 하였으나 이통사 3사 등록이 완료되지 않은 상태로 RCS 메시지를 발송할 수 없습니다.</li><li>승인대기(수정) : 승인된 템플릿 변경 승인요청 직후 검수 이전 상태입니다.</li><li>검수시작(수정) : 승인된 템플릿 변경으로 승인요청된 템플릿 검수가 시작된 상태입니다.</li><li>반려(수정) : 승인된 템플릿 변경 검수 처리 결과 반려된 상태입니다.</li><li>검수완료(수정) : 승인된 브랜드 변경 검수 승인은 되었으나 이통3사 정보 등록이 완료되지 않은 상태입니다. 현재 상태에서는 이통사에 따라 단말 브랜드 홈 정보가 다를 수 있습니다</li></ul></td></tr><tr><td><strong><code>approvalReason</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>승인 사유</td></tr><tr><td><strong><code>registerDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 등록일시</td></tr><tr><td><strong><code>approvalDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 승인일시</td></tr><tr><td><strong><code>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 수정일시</td></tr><tr><td><strong><code>registerId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 등록 계정 ID</td></tr><tr><td><strong><code>updateId</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>템플릿 수정 계정 ID</td></tr></tbody></table>

### <mark style="color:blue;">pagination</mark> - object

<table data-full-width="true"><thead><tr><th width="143">필드명</th><th width="91">타입</th><th width="98" align="center">길이</th><th width="112" align="center">필수여부</th><th width="93">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>total</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td></td><td>전체건수</td></tr><tr><td><strong><code>offset</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>0</td><td>조회 기준 위치</td></tr><tr><td><strong><code>limit</code></strong></td><td>integer</td><td align="center"></td><td align="center">O</td><td>100</td><td>페이지 당 조회 건수</td></tr></tbody></table>

### <mark style="color:blue;">links</mark> - object

<table data-full-width="true"><thead><tr><th width="145">필드명</th><th width="89">타입</th><th width="99" align="center">길이</th><th width="112" align="center">필수여부</th><th width="90">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>prev</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>이전페이지URL</td></tr><tr><td><strong><code>next</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td>다음페이지URL</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "groupId": null,
            "messagebaseId": "IBR.u720xwadx0-test20240620",
            "tmpltName": "SNS형 (중간버튼)",
            "messagebaseformId": "ITCRM3",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-20T10:33:23.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-20T10:33:23.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "IBR.u720xwadx0-test2024062010",
            "tmpltName": "이미지 강조형 (1:1)",
            "messagebaseformId": "ITHIMS",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-20T10:22:36.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-20T10:22:36.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "IBR.u720xwadx0-test2024062006",
            "tmpltName": "SNS형 (중간버튼)",
            "messagebaseformId": "ITSNSH",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-20T10:17:01.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-20T10:17:01.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "UBR.u720xwadx0-test2024062004",
            "tmpltName": "썸네일형 (가로)",
            "messagebaseformId": "TATA001D",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-20T10:11:34.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-20T10:11:34.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "IBR.u720xwadx0-test2024062002",
            "tmpltName": "이미지 강조형 (1:1)",
            "messagebaseformId": "ITHITS",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-20T10:08:06.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-20T10:08:06.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "IBR.u720xwadx0-test2024062001",
            "tmpltName": "이미지 & 타이틀 강조형 (1:1)",
            "messagebaseformId": "ITHITS",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-20T10:01:14.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-20T10:01:14.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "UBR.u720xwadx0-test2022072606",
            "tmpltName": "테마 강조형A 서술",
            "messagebaseformId": "TATA001C",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-19T11:11:39.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-19T11:11:39.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "UBR.u720xwadx0-test2024061905",
            "tmpltName": "테마 강조형A 서술",
            "messagebaseformId": "TATA001D",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-19T11:06:48.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-19T11:06:48.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "UBR.u720xwadx0-test202406183",
            "tmpltName": "테스트-출고(Cell)",
            "messagebaseformId": "CC001C",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": null,
            "registerDate": "2024-06-19T10:12:05.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-19T10:12:05.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "UBR.u720xwadx0-test2024061901",
            "tmpltName": "인증desc",
            "messagebaseformId": "GG002D",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": null,
            "registerDate": "2024-06-19T10:06:02.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-19T10:06:02.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "UBR.u720xwadx0-60JruEbrS2kBP55tU9SLWW3p5",
            "tmpltName": "승인내역",
            "messagebaseformId": "FF001C",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-18T18:03:47.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-18T18:03:47.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "UBR.u720xwadx0-3p807611jWP61Rn1BlBMPA095",
            "tmpltName": "승인번호템플릿",
            "messagebaseformId": "TATA001D",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": "승인대기(신규)",
            "registerDate": "2024-06-18T17:47:44.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-18T17:47:44.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        },
        {
            "groupId": null,
            "messagebaseId": "UBR.u720xwadx0-test2022072604",
            "tmpltName": "테마 강조형A 서술",
            "messagebaseformId": "TATA001D",
            "brandId": "BR.u720xwadx0",
            "status": "ready",
            "approvalResult": "승인대기",
            "approvalReason": null,
            "registerDate": "2024-06-18T17:38:07.000+09",
            "approvalDate": null,
            "updateDate": "2024-06-18T17:38:07.000+09",
            "registerId": "swjeong75",
            "updateId": "swjeong75"
        }
    ],
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 13
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64002",
        "message": "Invalid Brand Key"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](/rbc-api/error_code.md#rcs-biz-center-response-body-error-code) 참조
{% endhint %}