> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/api-en/store-front-api-reference/goods-api/brand.md).

# Brand

## Retrieve Brand Information

> \## Function Description\
> \* Retrieves brand information.\
> \---\
> \## Detailed Description\
> \* Retrieves detailed information about a brand.\
> \---\
> \## Validation Details\
> \* 1001 : Occurs when the request value is missing.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BrandRequest":{"type":"object","description":"Brand Inquiry Condition DTO","properties":{"langCd":{"type":"string","default":"ko","description":"Language Code (CM009)"},"siteNo":{"type":"string","default":"1","description":"Site No.: 1, 2, 3, ..."},"pageNo":{"type":"integer","format":"int32","description":"Requested Page No."},"pageSize":{"type":"integer","format":"int32","description":"Requested Page Size"},"dispYn":{"type":"string","default":"Y","description":"Display Status: Y/N","enum":["Y","N"]},"brandNo":{"type":"array","description":"Brand No. : 123, ...","items":{"type":"string"}},"brandNm":{"type":"string","description":"Brand Name"},"schKwdNm":{"type":"string","description":"Search Keywords"},"offset":{"type":"integer","format":"int64"}}},"BrandResponse":{"type":"object","description":"Brand Search Result DTO","properties":{"brandNo":{"type":"string","description":"Brand No."},"useYn":{"type":"string","description":"Usage Status"},"brandImgPathNm":{"type":"string","description":"Brand Image Path"},"brandImgFileNm":{"type":"string","description":"Brand Image File Name"},"langCd":{"type":"string","description":"Language Code (CM009) ko: Korean, en: English"},"brandNm":{"type":"string","description":"Brand Name"},"brandDescCmt":{"type":"string","description":"Brand Description"},"schKwdNm":{"type":"string","description":"Search Keyword"},"totalCnt":{"type":"integer","format":"int32","description":"Count"},"productList":{"type":"array","description":"Product List","items":{"$ref":"#/components/schemas/BrandProductSummaryResponse"}}}},"BrandProductSummaryResponse":{"type":"object","description":"Product Search Summary Information Search Result DTO","properties":{"goodsNo":{"type":"string","description":"Product No."},"entrNo":{"type":"string","description":"Vendor No."},"goodsCompCd":{"type":"string","description":"Product Composition Code (PR001) 10: General Product, 20: Bundled Product"},"goodsTypCd":{"type":"string","description":"Product Type Code (PR002) 10: General Product, 20: Free Gift, 30: E-Coupon Product"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003) 10: General Sale, 20: Reservation Sale"},"brandNo":{"type":"string","description":"Brand No."},"buyrAgeLmtCd":{"type":"string","description":"Buyer Age Restriction Code (PR004) 0: None, 15: Age 15+, 19: Age 19+, 12: Age 12+"},"dispYn":{"type":"string","description":"Display Status"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005) 01: Temporary Save, 02: Pending Approval, 03: Rejected, 10: On Sale, 20: Sold Out, 30: Discontinued"},"goodsRegDtm":{"type":"string","format":"date-time","description":"Product Registration Date/Time"},"saleStrDtm":{"type":"string","format":"date-time","description":"Sales Start Date/Time"},"saleEndDtm":{"type":"string","format":"date-time","description":"Sales End Date/Time"},"stkMgrYn":{"type":"string","description":"Inventory Management Status"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008) 10: Center Delivery, 20: Vendor Delivery, 30: E-Coupon Delivery"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Classification Code (PR010) 01: General Product, 02: Installation Product, 03: Made-to-Order, 04: E-Coupon"},"deliWayCd":{"type":"string","description":"Delivery Method Code (PR009) 01: Courier Delivery, 02: No Delivery"},"deliDday":{"type":"string","description":"Delivery Lead Time"},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"prcHistStrDtm":{"type":"string","format":"date-time","description":"Price History Start Date/Time"},"prcHistEndDtm":{"type":"string","format":"date-time","description":"Price History End Date/Time"},"rcntSalePrc":{"type":"string","description":"Recent Selling Price"},"salePrc":{"type":"string","description":"Selling Price"},"aplyPrc":{"type":"string","description":"Applied Price"},"dcRate":{"type":"string","description":"Discount Rate"},"dispCtgNo":{"type":"string","description":"Display Category No."},"dlexTypCd":{"type":"string","description":"Delivery Fee Type Code (VD005) 10: Free, 20: Paid, 30: Conditionally Free"},"goodsImmedDcCpnNo":{"type":"string","description":"Product Instant Discount Coupon No."},"goodsImmedDcAplyStrDtm":{"type":"string","format":"date-time","description":"Product Instant Discount Application Start Date/Time"},"fixamtFxrtGbCd":{"type":"string","description":"Product Instant Fixed Amount/Rate Type Code (MK005)"},"dcRateAmt":{"type":"string","description":"Product Instant Discount Rate/Amount"},"goodsRepImgContSn":{"type":"string","description":"Product Main Image Content Serial No."},"rservSaleYn":{"type":"string","description":"Reservation Sale Status"},"rservStrDtm":{"type":"string","format":"date-time","description":"Reservation Start Date/Time"},"rservEndDtm":{"type":"string","format":"date-time","description":"Reservation End Date/Time"},"goodsRevCnt":{"type":"string","description":"Product Review Count"},"goodsRevHlpfulCnt":{"type":"string","description":"Product Review Helpful Count"},"goodsRevStfdVal":{"type":"string","description":"Product Review Satisfaction Value"},"wishListCnt":{"type":"string","description":"Wishlist Count"},"ordQty":{"type":"string","description":"Order Quantity"},"langCd":{"type":"string","description":"Language Code (CM009) ko: Korean, en: English"},"goodsNm":{"type":"string","description":"Product Name"},"adveWrd":{"type":"string","description":"Promotional Text"},"prestNm":{"type":"string","description":"Gift Item Name"},"brandNm":{"type":"string","description":"Brand Name"},"brandImgPathNm":{"type":"string","description":"Brand Image Path"},"brandImgFileNm":{"type":"string","description":"Brand Image File Name"},"goodsRepImgPathNm":{"type":"string","description":"Product Main Image"},"trnfTextCont":{"type":"string","description":"Product Main Image Alt Text"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/brands/list":{"post":{"tags":["Brand"],"summary":"Retrieve Brand Information","description":"## Function Description\n* Retrieves brand information.\n---\n## Detailed Description\n* Retrieves detailed information about a brand.\n---\n## Validation Details\n* 1001 : Occurs when the request value is missing.\n","operationId":"seltBrandsList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandRequest"}}},"required":true},"responses":{"200":{"description":"Retrieve Brand Information Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BrandResponse"}}}}},"900":{"description":"Retrieve Brand Information Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Retrieve New Products by Brand

> \## Function Description\
> \* Retrieves information on new products by brand.\
> \---\
> \## Detailed Description\
> \* Retrieves 10 products per brand, ordered by most recent product registration date.\
> \---\
> \## Validation Details\
> \* 1001 : Occurs when the request value is missing, or when the brand number is missing from the request value.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BrandRequest":{"type":"object","description":"Brand Inquiry Condition DTO","properties":{"langCd":{"type":"string","default":"ko","description":"Language Code (CM009)"},"siteNo":{"type":"string","default":"1","description":"Site No.: 1, 2, 3, ..."},"pageNo":{"type":"integer","format":"int32","description":"Requested Page No."},"pageSize":{"type":"integer","format":"int32","description":"Requested Page Size"},"dispYn":{"type":"string","default":"Y","description":"Display Status: Y/N","enum":["Y","N"]},"brandNo":{"type":"array","description":"Brand No. : 123, ...","items":{"type":"string"}},"brandNm":{"type":"string","description":"Brand Name"},"schKwdNm":{"type":"string","description":"Search Keywords"},"offset":{"type":"integer","format":"int64"}}},"ResponseMapStringObject":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","additionalProperties":{},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/brands/brandNewGoodslist":{"post":{"tags":["Brand"],"summary":"Retrieve New Products by Brand","description":"## Function Description\n* Retrieves information on new products by brand.\n---\n## Detailed Description\n* Retrieves 10 products per brand, ordered by most recent product registration date.\n---\n## Validation Details\n* 1001 : Occurs when the request value is missing, or when the brand number is missing from the request value.\n","operationId":"seltBrandNewGoodsList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandRequest"}}},"required":true},"responses":{"200":{"description":"New Products by Brand Info Inquiry Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringObject"}}}},"900":{"description":"New Products by Brand Info Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Retrieve Best Products by Brand

> \## Function Description\
> \* Retrieves information on BEST products by brand.\
> \---\
> \## Detailed Description\
> \* Retrieves 10 products per brand, ordered by most recent product registration date.\
> \---\
> \## Validation Details\
> \* 1001 : Occurs when the request value is missing, or when the brand number is missing from the request value.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BrandRequest":{"type":"object","description":"Brand Inquiry Condition DTO","properties":{"langCd":{"type":"string","default":"ko","description":"Language Code (CM009)"},"siteNo":{"type":"string","default":"1","description":"Site No.: 1, 2, 3, ..."},"pageNo":{"type":"integer","format":"int32","description":"Requested Page No."},"pageSize":{"type":"integer","format":"int32","description":"Requested Page Size"},"dispYn":{"type":"string","default":"Y","description":"Display Status: Y/N","enum":["Y","N"]},"brandNo":{"type":"array","description":"Brand No. : 123, ...","items":{"type":"string"}},"brandNm":{"type":"string","description":"Brand Name"},"schKwdNm":{"type":"string","description":"Search Keywords"},"offset":{"type":"integer","format":"int64"}}},"ResponseMapStringObject":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","additionalProperties":{},"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/brands/brandBestGoodslist":{"post":{"tags":["Brand"],"summary":"Retrieve Best Products by Brand","description":"## Function Description\n* Retrieves information on BEST products by brand.\n---\n## Detailed Description\n* Retrieves 10 products per brand, ordered by most recent product registration date.\n---\n## Validation Details\n* 1001 : Occurs when the request value is missing, or when the brand number is missing from the request value.\n","operationId":"seltBrandBestGoodsList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandRequest"}}},"required":true},"responses":{"200":{"description":"BEST Products by Brand Info Inquiry Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMapStringObject"}}}},"900":{"description":"BEST Products by Brand Info Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```