> 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/feed-api/feed/get_feed_list.md).

# 브랜드 소식 목록 조회

## Request

## 브랜드 소식의 소식 목록을 조회합니다.<br>

> 브랜드 소식의 소식 목록을 조회합니다.\
> 브랜드 내 소식은 최대 100개까지 유지됩니다.<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center 브랜드 소식 API 규격","version":"1.0.0"},"servers":[{"url":"https://api-qa.rcsbizcenter.com/bfapi/1.0","description":"RCS Biz Center API for Staging"},{"url":"https://api.rcsbizcenter.com/bfapi/1.0","description":"RCS Biz Center API for Production"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/brand/{brandId}/feed":{"get":{"summary":"브랜드 소식의 소식 목록을 조회합니다.\n","description":"브랜드 소식의 소식 목록을 조회합니다.\n브랜드 내 소식은 최대 100개까지 유지됩니다.\n","parameters":[{"name":"X-RCS-Brandkey","in":"header","description":"maxLength: 36 - RCS Biz Center에서 브랜드 등록 시 자동 생성되는 Key 입니다. 대행사가 브랜드 소식 API 연동 시 Header에 반드시 설정하여야 합니다.","required":false,"schema":{"type":"string"}},{"name":"brandId","in":"path","description":"브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.","required":true,"schema":{"type":"string"}},{"name":"offset","in":"query","description":"시작 offset 번호(default: 0) 입니다.","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","description":"maxLength: 1000 - 조회 최대 건수(default: 100, maxLength: 1000) 입니다.","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

## Response

<table data-full-width="true"><thead><tr><th width="153">필드명</th><th width="114">타입</th><th width="68" align="center">길이</th><th width="86" align="center">필수여부</th><th width="117">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-brandfeed-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;BrandFeed></td><td align="center"></td><td align="center">O</td><td></td><td>브랜드소식정보</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"><mark style="color:blue;"><strong><code>pagination</code></strong></mark></a></td><td>Pagination</td><td align="center"></td><td align="center">O</td><td></td><td>전체건수와 페이징조건</td></tr><tr><td><a href="#links"><mark style="color:blue;"><strong><code>links</code></strong></mark></a></td><td>Links</td><td align="center"></td><td align="center">O</td><td></td><td>이전/다음</td></tr></tbody></table>

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

<table data-full-width="true"><thead><tr><th width="125">필드명</th><th width="110">타입</th><th width="70" align="center">길이</th><th width="87" align="center">필수여부</th><th width="84">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>브랜드 ID</td></tr><tr><td><strong><code>feedId</code></strong></td><td>string</td><td align="center">10</td><td align="center">O</td><td></td><td>소식 ID</td></tr><tr><td><strong><code>title</code></strong></td><td>string</td><td align="center">40</td><td align="center">O</td><td></td><td>브랜드 소식 제목</td></tr><tr><td><strong><code>description</code></strong></td><td>string</td><td align="center">2000</td><td align="center">O</td><td></td><td>브랜드 소식 내용</td></tr><tr><td><strong><code>type</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>브랜드 소식 카드 유형<br>(gallery, share, slide)</td></tr><tr><td><strong><code>status</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td><p>소식의 상태값</p><ul><li>save: 저장(최종 등록되지 않은 임시저장 상태)</li><li>ok: 등록</li><li>hide: 비공개 - 숨김처리되어 목록에 비노출</li><li>delete: 논리 삭제(삭제된 소식은 수정 불가)</li></ul></td></tr><tr><td><strong><code>publishType</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td><p>소식의 게시 유형</p><ul><li>publish: 게시 - 정상 게시됨</li><li>reservation: 예약 - 지정한 일자에 소식목록에 표시되도록 예약된 소식</li><li>internet: 숨김게시 - 소식목록에 표시되지 않지만 URL을 통해 접근 가능한 소</li></ul></td></tr><tr><td><strong><code>publishDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>게시 일자.</td></tr><tr><td><strong><code>pinYn</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td>N</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>updateDate</code></strong></td><td>string</td><td align="center"></td><td align="center"></td><td></td><td>수정 일시</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>

<table data-full-width="true"><thead><tr><th width="125">필드명</th><th width="108">타입</th><th width="71" align="center">길이</th><th width="88" align="center">필수여부</th><th width="82">기본값</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>

<table data-full-width="true"><thead><tr><th width="125">필드명</th><th width="109">타입</th><th width="68" align="center">길이</th><th width="94" align="center">필수여부</th><th width="78">기본값</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": {
        "feedList": [
            {
                "feedId": "BR.61hBmMP164.bTt4UKL3BN",
                "brandId": "BR.61hBmMP164",
                "title": "share feed title",
                "description": "share feed discription",
                "type": "share",
                "status": "save",
                "publishType": "publish",
                "publishDate": "20201210181411",
                "pinYn": "N",
                "registerId": "swjeong75",
                "registerDate": "2024-07-04T11:00:55.000+09",
                "updateId": "swjeong75",
                "updateDate": "2024-07-04T11:00:55.000+09"
            },
            {
                "feedId": "BR.61hBmMP164.oQ6ay6aiZd",
                "brandId": "BR.61hBmMP164",
                "title": "gallery feed title",
                "description": "gallery feed discription",
                "type": "gallery",
                "status": "save",
                "publishType": "publish",
                "publishDate": "20201210181411",
                "pinYn": "N",
                "registerId": "swjeong75",
                "registerDate": "2024-07-04T10:44:21.000+09",
                "updateId": "swjeong75",
                "updateDate": "2024-07-04T10:44:21.000+09"
            }
        ]
    },
    "pagination": {
        "offset": 0,
        "limit": 100,
        "total": 2
    },
    "links": {
        "prev": null,
        "next": null
    },
    "status": 200
}
```

{% endtab %}

{% tab title="401" %}

```
{
  "status": "401",
  "error": {
    "code": "61001",
    "message": "Missing Authorization header"
  }
}

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

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [브랜드소식 - Response body error code](/feed-api/error_code.md#response-body-error-code) 참조
{% endhint %}