> 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/display-api/special-exhibition.md).
# Special Exhibition
## Retrieve Special Exhibition
> \## Function Description\
> \* API for retrieving special exhibition information based on the corresponding site/mall.\
> \---\
> \## Detailed Description\
> \* Retrieves special exhibition information based on site and mall.\
> \* If a special exhibition number is provided, retrieves the information corresponding to that number.\
> \* Retrieves special exhibition information according to brand number, sort type (latest, closing soon), and progress status.\
> \* Special exhibition exposure is restricted through authority checks based on membership grade and employee status.\
> \---\
> \## Special Notes\
> \* The authority check criteria are based on AND conditions: if ① Display Membership Grade (GREEN) and ② Employee-Only are both checked, the special exhibition is exposed only to 'employees + GREEN members'.\
> \* If none are checked, it is exposed to all users, including non-members.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Display API","version":"v1"},"servers":[{"url":"https://api-display.x2bee.com/api/display/","description":"prd"}],"paths":{"/v1/plan/planList":{"get":{"tags":["Special Exhibition"],"summary":"Retrieve Special Exhibition","description":"## Function Description\n* API for retrieving special exhibition information based on the corresponding site/mall.\n---\n## Detailed Description\n* Retrieves special exhibition information based on site and mall.\n* If a special exhibition number is provided, retrieves the information corresponding to that number.\n* Retrieves special exhibition information according to brand number, sort type (latest, closing soon), and progress status.\n* Special exhibition exposure is restricted through authority checks based on membership grade and employee status.\n---\n## Special Notes\n* The authority check criteria are based on AND conditions: if ① Display Membership Grade (GREEN) and ② Employee-Only are both checked, the special exhibition is exposed only to 'employees + GREEN members'.\n * If none are checked, it is exposed to all users, including non-members.\n","operationId":"getPlanList","parameters":[{"name":"dispMediaCd","in":"query","description":"Display Media Code (DP018)","required":true,"schema":{"type":"string","description":"string"}},{"name":"brandNo","in":"query","description":"Brand No.","schema":{"type":"string","description":"string"}},{"name":"sortType","in":"query","description":"Sort Type","schema":{"type":"string","description":"string"}},{"name":"pageNo","in":"query","description":"Requested Page No.","schema":{"type":"string","description":"integer"}},{"name":"pageSize","in":"query","description":"Requested Page Size","schema":{"type":"string","description":"integer"}},{"name":"progressYn","in":"query","description":"Progress Status","schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Retrieve Special Exhibition Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanModel"}}}},"400":{"description":"Retrieve Special Exhibition Failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"PlanModel":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int64","description":"Total Count"},"planInfoList":{"type":"array","description":"Promotion Information List","items":{"$ref":"#/components/schemas/PlanInfo"}}}},"PlanInfo":{"type":"object","description":"Promotion Information DTO","properties":{"mkdpNo":{"type":"string","description":"Special Exhibition No."},"mkdpNm":{"type":"string","description":"Special Exhibition Name"},"tmplNo":{"type":"string","description":"Template No."},"brefDesc":{"type":"string","description":"Brief Description"},"introConts":{"type":"string","description":"Introduction"},"pcTopYn":{"type":"string","description":"PC Top Fixed Status"},"dispSeq":{"type":"string","description":"Display Order"},"totalCount":{"type":"string","description":"Total Count"},"startDate":{"type":"string","format":"date-time","description":"Start Date"},"endDate":{"type":"string","format":"date-time","description":"End Date"},"wishContYn":{"type":"string","description":"Wishlist Status"},"imageList":{"type":"array","description":"Promotion Image List","items":{"$ref":"#/components/schemas/PlanImageContent"}}}},"PlanImageContent":{"type":"object","description":"Promotion Image Information DTO","properties":{"mkdpNo":{"type":"string","description":"Special Exhibition No."},"imgTypCd":{"type":"string","description":"Image Type Code (DP013)"},"contGbCd":{"type":"string","description":"Content Type Code (DP026)"},"bnrImgPathNm":{"type":"string","description":"Image Path"},"bnrImgAltCont":{"type":"string","description":"Image Alt Text"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
```
## Retrieve Special Exhibition
> \## Function Description\
> \* API for retrieving special exhibition information based on the corresponding site/mall.\
> \---\
> \## Detailed Description\
> \* Retrieves special exhibition information based on site and mall.\
> \* If a special exhibition number is provided, retrieves the information corresponding to that number.\
> \* Retrieves special exhibition information according to brand number, sort type (latest, closing soon), and progress status.\
> \* Special exhibition exposure is restricted through authority checks based on membership grade and employee status.\
> \---\
> \## Special Notes\
> \* The authority check criteria are based on AND conditions: if ① Display Membership Grade (GREEN) and ② Employee-Only are both checked, the special exhibition is exposed only to 'employees + GREEN members'.\
> \* If none are checked, it is exposed to all users, including non-members.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Display API","version":"v1"},"servers":[{"url":"https://api-display.x2bee.com/api/display/","description":"prd"}],"paths":{"/v1/plan/planWishList":{"get":{"tags":["Special Exhibition"],"summary":"Retrieve Special Exhibition","description":"## Function Description\n* API for retrieving special exhibition information based on the corresponding site/mall.\n---\n## Detailed Description\n* Retrieves special exhibition information based on site and mall.\n* If a special exhibition number is provided, retrieves the information corresponding to that number.\n* Retrieves special exhibition information according to brand number, sort type (latest, closing soon), and progress status.\n* Special exhibition exposure is restricted through authority checks based on membership grade and employee status.\n---\n## Special Notes\n* The authority check criteria are based on AND conditions: if ① Display Membership Grade (GREEN) and ② Employee-Only are both checked, the special exhibition is exposed only to 'employees + GREEN members'.\n * If none are checked, it is exposed to all users, including non-members.\n","operationId":"getPlanList_1","parameters":[{"name":"dispMediaCd","in":"query","description":"Display Media Code (DP018)","required":true,"schema":{"type":"string","description":"string"}},{"name":"brandNo","in":"query","description":"Brand No.","schema":{"type":"string","description":"string"}},{"name":"sortType","in":"query","description":"Sort Type","schema":{"type":"string","description":"string"}},{"name":"pageNo","in":"query","description":"Requested Page No.","schema":{"type":"string","description":"integer"}},{"name":"pageSize","in":"query","description":"Requested Page Size","schema":{"type":"string","description":"integer"}},{"name":"progressYn","in":"query","description":"Progress Status","schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Retrieve Special Exhibition Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanModel"}}}},"400":{"description":"Retrieve Special Exhibition Failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"PlanModel":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int64","description":"Total Count"},"planInfoList":{"type":"array","description":"Promotion Information List","items":{"$ref":"#/components/schemas/PlanInfo"}}}},"PlanInfo":{"type":"object","description":"Promotion Information DTO","properties":{"mkdpNo":{"type":"string","description":"Special Exhibition No."},"mkdpNm":{"type":"string","description":"Special Exhibition Name"},"tmplNo":{"type":"string","description":"Template No."},"brefDesc":{"type":"string","description":"Brief Description"},"introConts":{"type":"string","description":"Introduction"},"pcTopYn":{"type":"string","description":"PC Top Fixed Status"},"dispSeq":{"type":"string","description":"Display Order"},"totalCount":{"type":"string","description":"Total Count"},"startDate":{"type":"string","format":"date-time","description":"Start Date"},"endDate":{"type":"string","format":"date-time","description":"End Date"},"wishContYn":{"type":"string","description":"Wishlist Status"},"imageList":{"type":"array","description":"Promotion Image List","items":{"$ref":"#/components/schemas/PlanImageContent"}}}},"PlanImageContent":{"type":"object","description":"Promotion Image Information DTO","properties":{"mkdpNo":{"type":"string","description":"Special Exhibition No."},"imgTypCd":{"type":"string","description":"Image Type Code (DP013)"},"contGbCd":{"type":"string","description":"Content Type Code (DP026)"},"bnrImgPathNm":{"type":"string","description":"Image Path"},"bnrImgAltCont":{"type":"string","description":"Image Alt Text"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
```
## Retrieve Products by Promotion Divider
> \## Function Description\
> \* This API retrieves products by divider using the promotion number and divider number.\
> \---\
> \## Detailed Description\
> \* If no divider number is provided, retrieves information for all dividers.\
> \* Promotion dividers are displayed in order of display order, then divider number.\
> \* The product sort code can be used to set the display order of products. (default: 10)\
> \* If there are no products for the divider, an empty value is returned.\
> \---\
> \## Notes\
> \* The language code (dataLangCd) can be set via the promotion preview in the BO.\
> \---\
> \## Code Summary\
> \* \`\`\`Product Sort Code\`\`\` : 10: Newest, 20: Best-selling, 30: Highest price, 40: Lowest price, 50: Most reviewed
````json
{"openapi":"3.1.0","info":{"title":"X2BEE Display API","version":"v1"},"servers":[{"url":"https://api-display.x2bee.com/api/display/","description":"prd"}],"paths":{"/v1/plan/planGoodsInfo":{"get":{"tags":["Special Exhibition"],"summary":"Retrieve Products by Promotion Divider","description":"## Function Description\n* This API retrieves products by divider using the promotion number and divider number.\n---\n## Detailed Description\n* If no divider number is provided, retrieves information for all dividers.\n * Promotion dividers are displayed in order of display order, then divider number.\n* The product sort code can be used to set the display order of products. (default: 10)\n* If there are no products for the divider, an empty value is returned.\n---\n## Notes\n* The language code (dataLangCd) can be set via the promotion preview in the BO.\n---\n## Code Summary\n* ```Product Sort Code``` : 10: Newest, 20: Best-selling, 30: Highest price, 40: Lowest price, 50: Most reviewed\n","operationId":"getPlanGoodsInfo","parameters":[{"name":"mkdpNo","in":"query","description":"Special Exhibition No.","required":true,"schema":{"type":"string","description":"string"}},{"name":"dispMediaCd","in":"query","description":"Display Media Code (DP018)","required":true,"schema":{"type":"string","description":"string"}},{"name":"divobjNo","in":"query","description":"Classifier No.","schema":{"type":"string","description":"string"}},{"name":"sort","in":"query","description":"Product Sort Code","schema":{"type":"string","description":"string"}},{"name":"dataLangCd","in":"query","description":"Preview langCd","schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Products by promotion divider retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanDivObjInfo"}}}},"400":{"description":"Failed to retrieve products by promotion divider","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"PlanDivObjInfo":{"type":"object","description":"Promotion Divider DTO","properties":{"divobjNo":{"type":"string","description":"Classifier No."},"divobjNm":{"type":"string","description":"Delimiter Name"},"divobjGbCd":{"type":"string","description":"Divider Type Code"},"dispSeq":{"type":"string","description":"Display Order"},"tmplNo":{"type":"string","description":"Display Template No."},"textDivobjNm":{"type":"string","description":"Text Delimiter Name"},"bnrImgPathNm":{"type":"string","description":"Divider Image Path"},"bnrImgAltCont":{"type":"string","description":"Divider Image Alt Text"},"htmlFileCont":{"type":"string","description":"HTML File Content"},"cpnDnldYn":{"type":"string","description":"Coupon Download Status"},"cpnNo":{"type":"string","description":"Coupon No."},"cpnBnrImgPathNm":{"type":"string","description":"Coupon Banner Path"},"goodsNo":{"type":"string","description":"Product No."},"goodsList":{"type":"array","description":"Promotion Product List","items":{"$ref":"#/components/schemas/Goods"}}}},"Goods":{"type":"object","description":"Product DTO","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"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 Product"},"brandNo":{"type":"string","description":"Brand No."},"brandNm":{"type":"string","description":"Brand Name"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code (PR004) 0: 0, 15: 15"},"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"},"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":"integer","format":"int64","description":"Recent Selling Price"},"salePrc":{"type":"integer","format":"int64","description":"Selling Price"},"aplyPrc":{"type":"integer","format":"int64","description":"Applied Price (Display Price)"},"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"},"goodsImmedDcAplyEndDtm":{"type":"string","format":"date-time","description":"Product Instant Discount Application End Date/Time"},"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"},"goodsRevStarscrAvgVal":{"type":"number","format":"double","description":"Product Review Average Rating"},"fixamtFxrtGbCd":{"type":"string","description":"Product Instant Fixed Amount/Rate Type Code (MK005)"},"dcRateAmt":{"type":"integer","format":"int64","description":"Product Instant Discount Rate/Amount"},"dcRate":{"type":"integer","format":"int64","description":"Product Discount Rate"},"wishListCnt":{"type":"string","description":"Wishlist Count"},"goodsRepImgPathNm":{"type":"string","description":"Representative Image File Path"},"trnfTextCont":{"type":"string","description":"Representative Image Alt Text"},"adlCertiYn":{"type":"string","description":"Adult Verification Status"},"iconList":{"type":"array","description":"Icon Information","items":{"type":"string"}},"prcTimeDealYn":{"type":"string","description":"Time Deal Status"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
````
## Retrieve Promotion Details
> \## Function Description\
> \* This API retrieves the basic information, divider information, and related product information for a promotion using the promotion number.\
> \---\
> \## Detailed Description\
> \* Retrieves the promotion's basic information, divider list, related product list, recent promotion list, and promotion image list.\
> \* Products per divider are displayed in the configured display order.\
> \* If there are no products for the divider, an empty value is returned.\
> \* Promotion exposure is restricted based on a permission check according to member grade and employee status.\
> \---\
> \## Notes\
> \* The permission check applies an AND condition: if ① display member grade (GREEN) and ② employees-only are both checked, the promotion is displayed only to 'employees + GREEN'.\
> \* If neither is checked, the promotion is displayed to all users, including non-members.\
> \* If previewDate has a value, the promotion is displayed regardless of member grade or display status.\
> \* The language code (dataLangCd) can be set via the promotion preview in the BO.\
> \---\
> \## Validation Details\
> \* Error code 1003: No promotion data\
> \* Error code 7010: Promotion requires login\
> \* Error code 7020: Promotion member grade restricted
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Display API","version":"v1"},"servers":[{"url":"https://api-display.x2bee.com/api/display/","description":"prd"}],"paths":{"/v1/plan/planDetail/{mkdpNo}":{"get":{"tags":["Special Exhibition"],"summary":"Retrieve Promotion Details","description":"## Function Description\n* This API retrieves the basic information, divider information, and related product information for a promotion using the promotion number.\n---\n## Detailed Description\n* Retrieves the promotion's basic information, divider list, related product list, recent promotion list, and promotion image list.\n* Products per divider are displayed in the configured display order.\n* If there are no products for the divider, an empty value is returned.\n* Promotion exposure is restricted based on a permission check according to member grade and employee status.\n---\n## Notes\n* The permission check applies an AND condition: if ① display member grade (GREEN) and ② employees-only are both checked, the promotion is displayed only to 'employees + GREEN'.\n * If neither is checked, the promotion is displayed to all users, including non-members.\n* If previewDate has a value, the promotion is displayed regardless of member grade or display status.\n* The language code (dataLangCd) can be set via the promotion preview in the BO.\n---\n## Validation Details\n* Error code 1003: No promotion data\n* Error code 7010: Promotion requires login\n* Error code 7020: Promotion member grade restricted\n","operationId":"getPlanDetailInfo","parameters":[{"name":"mkdpNo","in":"path","description":"Special Exhibition No.","required":true,"schema":{"type":"string","description":"string"}},{"name":"dispMediaCd","in":"query","description":"Display Media Code (DP018)","required":true,"schema":{"type":"string","description":"string"}},{"name":"previewDate","in":"query","description":"Preview","schema":{"type":"string","description":"localDate"}},{"name":"dataLangCd","in":"query","description":"Preview langCd","schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Promotion details retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanDetailInfo"}}}},"1003":{"description":"No promotion data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}},"7010":{"description":"Member login required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}},"7020":{"description":"Promotion member grade restricted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"PlanDetailInfo":{"type":"object","description":"Promotion Detail Response DTO","properties":{"resultCd":{"type":"string","description":"Error Result Code"},"resultMsg":{"type":"string","description":"Error Result Message"},"mkdpNo":{"type":"string","description":"Special Exhibition No."},"mkdpNm":{"type":"string","description":"Special Exhibition Name"},"tmplNo":{"type":"string","description":"Template No."},"tmplFileNm":{"type":"string","description":"Template File Name"},"startDate":{"type":"string","format":"date-time","description":"Start Date"},"endDate":{"type":"string","format":"date-time","description":"End Date"},"introCont":{"type":"string","description":"Introduction"},"briefDescription":{"type":"string","description":"Brief Description"},"titleHtml":{"type":"string","description":"Title HTML"},"titleHtmlPc":{"type":"string","description":"PC Title HTML"},"footerContents":{"type":"string","description":"Footer File Content"},"wishContYn":{"type":"string","description":"Wishlist Status"},"pcTopYn":{"type":"string","description":"Pinned Status"},"staffYn":{"type":"string","description":"Employee Status"},"planDivObjList":{"type":"array","description":"Promotion Divider List","items":{"$ref":"#/components/schemas/PlanDivObjInfo"}},"recentPlanList":{"type":"array","description":"Recent Promotion List","items":{"$ref":"#/components/schemas/PlanInfo"}},"titleImgMovList":{"type":"array","description":"Promotion Image List","items":{"$ref":"#/components/schemas/PlanImageContent"}}}},"PlanDivObjInfo":{"type":"object","description":"Promotion Divider DTO","properties":{"divobjNo":{"type":"string","description":"Classifier No."},"divobjNm":{"type":"string","description":"Delimiter Name"},"divobjGbCd":{"type":"string","description":"Divider Type Code"},"dispSeq":{"type":"string","description":"Display Order"},"tmplNo":{"type":"string","description":"Display Template No."},"textDivobjNm":{"type":"string","description":"Text Delimiter Name"},"bnrImgPathNm":{"type":"string","description":"Divider Image Path"},"bnrImgAltCont":{"type":"string","description":"Divider Image Alt Text"},"htmlFileCont":{"type":"string","description":"HTML File Content"},"cpnDnldYn":{"type":"string","description":"Coupon Download Status"},"cpnNo":{"type":"string","description":"Coupon No."},"cpnBnrImgPathNm":{"type":"string","description":"Coupon Banner Path"},"goodsNo":{"type":"string","description":"Product No."},"goodsList":{"type":"array","description":"Promotion Product List","items":{"$ref":"#/components/schemas/Goods"}}}},"Goods":{"type":"object","description":"Product DTO","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"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 Product"},"brandNo":{"type":"string","description":"Brand No."},"brandNm":{"type":"string","description":"Brand Name"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code (PR004) 0: 0, 15: 15"},"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"},"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":"integer","format":"int64","description":"Recent Selling Price"},"salePrc":{"type":"integer","format":"int64","description":"Selling Price"},"aplyPrc":{"type":"integer","format":"int64","description":"Applied Price (Display Price)"},"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"},"goodsImmedDcAplyEndDtm":{"type":"string","format":"date-time","description":"Product Instant Discount Application End Date/Time"},"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"},"goodsRevStarscrAvgVal":{"type":"number","format":"double","description":"Product Review Average Rating"},"fixamtFxrtGbCd":{"type":"string","description":"Product Instant Fixed Amount/Rate Type Code (MK005)"},"dcRateAmt":{"type":"integer","format":"int64","description":"Product Instant Discount Rate/Amount"},"dcRate":{"type":"integer","format":"int64","description":"Product Discount Rate"},"wishListCnt":{"type":"string","description":"Wishlist Count"},"goodsRepImgPathNm":{"type":"string","description":"Representative Image File Path"},"trnfTextCont":{"type":"string","description":"Representative Image Alt Text"},"adlCertiYn":{"type":"string","description":"Adult Verification Status"},"iconList":{"type":"array","description":"Icon Information","items":{"type":"string"}},"prcTimeDealYn":{"type":"string","description":"Time Deal Status"}}},"PlanInfo":{"type":"object","description":"Promotion Information DTO","properties":{"mkdpNo":{"type":"string","description":"Special Exhibition No."},"mkdpNm":{"type":"string","description":"Special Exhibition Name"},"tmplNo":{"type":"string","description":"Template No."},"brefDesc":{"type":"string","description":"Brief Description"},"introConts":{"type":"string","description":"Introduction"},"pcTopYn":{"type":"string","description":"PC Top Fixed Status"},"dispSeq":{"type":"string","description":"Display Order"},"totalCount":{"type":"string","description":"Total Count"},"startDate":{"type":"string","format":"date-time","description":"Start Date"},"endDate":{"type":"string","format":"date-time","description":"End Date"},"wishContYn":{"type":"string","description":"Wishlist Status"},"imageList":{"type":"array","description":"Promotion Image List","items":{"$ref":"#/components/schemas/PlanImageContent"}}}},"PlanImageContent":{"type":"object","description":"Promotion Image Information DTO","properties":{"mkdpNo":{"type":"string","description":"Special Exhibition No."},"imgTypCd":{"type":"string","description":"Image Type Code (DP013)"},"contGbCd":{"type":"string","description":"Content Type Code (DP026)"},"bnrImgPathNm":{"type":"string","description":"Image Path"},"bnrImgAltCont":{"type":"string","description":"Image Alt Text"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
```
## Retrieve Special Exhibition Group List
> \## Function Description\
> \* This API retrieves the list of promotion groups for the site and mall.\
> \---\
> \## Detailed Description\
> \* Retrieves the promotion group list using the site number and mall number from the cookie value.\
> \* Retrieves only information where the usage status is Y and the current date falls within the display period.\
> \* The promotion group list is displayed in ascending order of display order.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Display API","version":"v1"},"servers":[{"url":"https://api-display.x2bee.com/api/display/","description":"prd"}],"paths":{"/v1/plan/group":{"get":{"tags":["Special Exhibition"],"summary":"Retrieve Special Exhibition Group List","description":"## Function Description\n* This API retrieves the list of promotion groups for the site and mall.\n---\n## Detailed Description\n* Retrieves the promotion group list using the site number and mall number from the cookie value.\n* Retrieves only information where the usage status is Y and the current date falls within the display period.\n* The promotion group list is displayed in ascending order of display order.\n","operationId":"getPlanGroupList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Promotion group retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanGroupInfo"}}}},"400":{"description":"Failed to retrieve promotion group","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"PlanGroupInfo":{"type":"object","description":"Promotion Group Information DTO","properties":{"dispGrpNo":{"type":"string","description":"Display Group No."},"dispGrpNm":{"type":"string","description":"Display Group Name"},"dispSeq":{"type":"string","description":"Display Order"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
```
## Retrieve Promotion Brand
> \## Function Description\
> \* This API retrieves the list of promotion brands for the site and mall.\
> \---\
> \## Detailed Description\
> \* Retrieves the promotion brand list using the site number and mall number from the cookie value.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Display API","version":"v1"},"servers":[{"url":"https://api-display.x2bee.com/api/display/","description":"prd"}],"paths":{"/v1/plan/brand":{"get":{"tags":["Special Exhibition"],"summary":"Retrieve Promotion Brand","description":"## Function Description\n* This API retrieves the list of promotion brands for the site and mall.\n---\n## Detailed Description\n* Retrieves the promotion brand list using the site number and mall number from the cookie value.\n","operationId":"getPlanBrandList","parameters":[{"name":"dispMediaCd","in":"query","description":"Display Media Code (DP018)","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Promotion brand retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Brand"}}}},"400":{"description":"Failed to retrieve promotion brand","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}},"components":{"schemas":{"Brand":{"type":"object","description":"Brand 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"},"brandNm":{"type":"string","description":"Brand Name"},"brandDescCmt":{"type":"string","description":"Brand Description"},"schKwdNm":{"type":"string","description":"Search Keyword"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}}}
```