> 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/event-api/event-lookup.md). # Event Lookup ## Retrieve Event Comment > \## Function Description\ > \* This is an API to retrieve event comments.\ > \---\ > \## Detailed Description\ > \* Retrieves all comments or comments written by the user.\ > \## Revision History\ > \* Release v2.00\_240401 : Initial development of event comment retrieval\ > \* Release v2.00\_240425: Added site number to the event comment list search conditions
```json {"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/marketing/getEventReplies":{"get":{"tags":["Event Lookup"],"summary":"Retrieve Event Comment","description":"## Function Description\n* This is an API to retrieve event comments.\n---\n## Detailed Description\n* Retrieves all comments or comments written by the user.\n## Revision History\n* Release v2.00_240401 : Initial development of event comment retrieval\n* Release v2.00_240425: Added site number to the event comment list search conditions\n","operationId":"getEventReplies","parameters":[{"name":"siteNo","in":"query","description":"Site No.","schema":{"type":"string","description":"string"}},{"name":"evtNo","in":"query","description":"Event No.","required":true,"schema":{"type":"string","description":"string"}},{"name":"isAllReply","in":"query","description":"Retrieve All Status","schema":{"type":"string","description":"string"}},{"name":"pageIdx","in":"query","description":"Current Page","schema":{"type":"string","description":"string"}},{"name":"rowsPerPage","in":"query","description":"Rows per Page","schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Event comment retrieved successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EventReplyResponse"}}}},"900":{"description":"Failed to retrieve event comment","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EventReplyResponse":{"type":"object","description":"Event Comment Information Response","properties":{"totalCount":{"type":"integer","format":"int32"},"replyList":{"type":"array","items":{"$ref":"#/components/schemas/CcEvtBbInfoResponse"}}}},"CcEvtBbInfoResponse":{"type":"object","description":"Event Bulletin Board Information Response","properties":{"bbcNo":{"type":"string","description":"Post Number"},"evtNo":{"type":"string","description":"Event No."},"evtTmplRelNo":{"type":"string","description":"Event Template Relation No."},"evtBbGbCd":{"type":"string","description":"Event Bulletin Board Type Code (EV023)"},"bbcTitleNm":{"type":"string","description":"Post Title Name"},"bbcCont":{"type":"string","description":"Post Content"},"wrtmnNm":{"type":"string","description":"Author Name"},"wrtmnEmailAddr":{"type":"string","description":"Author Email Address"},"mbrNo":{"type":"string","description":"Member No."},"goodsNo":{"type":"string","description":"Product No."},"dispSeq":{"type":"integer","format":"int32","description":"Display Order"},"qryCnt":{"type":"integer","format":"int32","description":"View Count"},"recomCnt":{"type":"integer","format":"int32","description":"Recommendation Count"},"dispYn":{"type":"string","default":"Y","description":"Display Status"},"pblYn":{"type":"string","description":"Public Status"},"delYn":{"type":"string","description":"Deletion Status"},"regDt":{"type":"string","description":"Registration Date"},"mbrNm":{"type":"string","description":"Member Name"},"loginId":{"type":"string","description":"Member ID"}}},"Response":{"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":{"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"}}}}}} ``` ## Retrieve Event List > \## Function Description\ > \* This is an API to retrieve the basic event list.\ > \---\ > \## Detailed Description\ > \* Displays up to 10 events per page.\ > \* Events are displayed sorted according to the Latest/Deadline select box value.\ > \* One pinned event is always displayed at the top.\ > \* Survey events are not displayed in the list.\ > \---\ > \## Code Summary\ > \* \`\`\`Latest/Deadline\`\`\` : 01: Latest, 02: Deadline\ > \## Revision History\ > \* Release v2.00\_240425: Added site number to the event list search conditions
````json {"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/marketing/getEventList":{"get":{"tags":["Event Lookup"],"summary":"Retrieve Event List","description":"## Function Description\n* This is an API to retrieve the basic event list.\n---\n## Detailed Description\n* Displays up to 10 events per page.\n* Events are displayed sorted according to the Latest/Deadline select box value.\n* One pinned event is always displayed at the top.\n* Survey events are not displayed in the list.\n---\n## Code Summary\n* ```Latest/Deadline``` : 01: Latest, 02: Deadline\n## Revision History\n* Release v2.00_240425: Added site number to the event list search conditions\n","operationId":"getEventList","parameters":[{"name":"siteNo","in":"query","description":"Site No.","schema":{"type":"string","description":"string"}},{"name":"pageIdx","in":"query","description":"Current Page","required":true,"schema":{"type":"string","description":"string"}},{"name":"rowsPerPage","in":"query","description":"Rows per Page","required":true,"schema":{"type":"string","description":"string"}},{"name":"evtSortGb","in":"query","description":"Latest/Deadline","required":true,"schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Event list retrieved successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EventInfoResponse"}}}},"900":{"description":"Failed to retrieve event list","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EventInfoResponse":{"type":"object","description":"Event List Information Response","properties":{"allPageCnt":{"type":"integer","format":"int32","description":"Total Page Count"},"curPageNo":{"type":"integer","format":"int32","description":"Current Page No."},"evtBrandList":{"type":"array","description":"Event Brand List","items":{"$ref":"#/components/schemas/CcEvtAplyInfoResponse"}},"evtBaseInfo":{"type":"array","description":"Event List Detail","items":{"$ref":"#/components/schemas/EventInfoDetailResponse"}},"uprFixEvtInfo":{"$ref":"#/components/schemas/EventInfoDetailResponse","description":"Pinned Event Detail"}}},"CcEvtAplyInfoResponse":{"type":"object","description":"Event Applicable Scope Information Response","properties":{"brandNo":{"type":"string","description":"Brand No."},"brandNm":{"type":"string","description":"Brand Name"}}},"EventInfoDetailResponse":{"type":"object","description":"Event List Detail Response","properties":{"evtNo":{"type":"string","description":"Event No."},"evtNm":{"type":"string","description":"Event Name"},"uprFixYn":{"type":"string","description":"Pinned Status"},"evtObjCd":{"type":"string","description":"Event Purpose (EV004)"},"evtLgrpCd":{"type":"string","description":"Event Type Major Category Code (EV001)"},"evtMgrpCd":{"type":"string","description":"Event Type Subcategory Code (EV002)"},"evtExpNmCd":{"type":"string","description":"Event Display Name Code (EV003)"},"sbscCntLmtCd":{"type":"string","description":"Number of Entries (EV007)"},"evtPrgsStatCd":{"type":"string","description":"Management Status (EV005)"},"evtStrDtm":{"type":"string","format":"date-time","description":"Event Start Date"},"evtEndDtm":{"type":"string","format":"date-time","description":"Event End Date"},"buyStrDtm":{"type":"string","format":"date-time","description":"Purchase Period Start Date"},"buyEndDtm":{"type":"string","format":"date-time","description":"Purchase Period End Date"},"sbscAplyStrDtm":{"type":"string","format":"date-time","description":"Application Period Start Date"},"sbscAplyEndDtm":{"type":"string","format":"date-time","description":"Application Period End Date"},"evtUrlAddr":{"type":"string","description":"Event URL"},"evtBnrPathNm":{"type":"string","description":"Event Banner Path"},"evtBnrFileNm":{"type":"string","description":"Event Banner File Name"},"evtBnrAltCont":{"type":"string","description":"Event Banner Image Alt Text"},"pcEvtBnrPathNm":{"type":"string","description":"PC Event Banner Path"},"pcEvtBnrFileNm":{"type":"string","description":"PC Event Banner File Name"},"pcEvtBnrAltCont":{"type":"string","description":"PC Event Banner Image Alt Text"},"dispYn":{"type":"string","default":"Y","description":"Display Status"},"expYn":{"type":"string","description":"Exposure Status"},"evtSchTag":{"type":"string","description":"Event Search Tag"},"evtTrgmnGbCd":{"type":"string","description":"Event Target Classification Code (EV012)"},"mbrGbCdList":{"type":"array","description":"Entry Member Category","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"mbrGradeCdList":{"type":"array","description":"Entry Member Grade","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"dispMbrGradeList":{"type":"array","description":"Display Membership Grade","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}}}},"CcEvtAplyGradeInfo":{"type":"object","description":"Event Applicable Grade Information","properties":{"evtNo":{"type":"string","description":"Event No."},"expGradeGbCd":{"type":"string","description":"Exposure Grade Type Code (EV018) [10: Entrant Management Code, 20: Entrant Grade Code]"},"expTgtNo":{"type":"string","description":"Exposure Target No. (ME002, ME008)\n* `ME002` : [ 10 : Integrated Member, 20 : General Member, 30 : Social Member, 99 : Non-Member ]

\n* `ME008` : [ 10 : GREEN, 20 : FAMILY, 30 : GOLD, 40 : VIP, 50 : VVIP ]

\n"}}},"Response":{"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":{"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"}}}}}} ```` ## Retrieve Event Details > \## Function Description\ > \* This is the basic API for retrieving event details.\ > \---\ > \## Detailed Description\ > \* Retrieves data related to each event according to the event type.\ > \* Retrieves the latest 4 events (excluding surveys).\ > \* Survey events are excluded.\ > \## Revision History\ > \* Release v2.00\_240401 : Added retrieval of purchaser drawing and purchase gift events\ > \* Release v2.00\_240425: Added site number to the event detail retrieval and latest event list search conditions
```json {"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/marketing/getEventDetail":{"get":{"tags":["Event Lookup"],"summary":"Retrieve Event Details","description":"## Function Description\n* This is the basic API for retrieving event details.\n---\n## Detailed Description\n* Retrieves data related to each event according to the event type.\n* Retrieves the latest 4 events (excluding surveys).\n* Survey events are excluded.\n## Revision History\n* Release v2.00_240401 : Added retrieval of purchaser drawing and purchase gift events\n* Release v2.00_240425: Added site number to the event detail retrieval and latest event list search conditions\n","operationId":"getEventDetail","parameters":[{"name":"siteNo","in":"query","description":"Site No.","schema":{"type":"string","description":"string"}},{"name":"evtNo","in":"query","description":"Event No.","required":true,"schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Event details retrieved successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EventListDetailResponse"}}}},"900":{"description":"Failed to retrieve event details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EventListDetailResponse":{"type":"object","description":"Event List Detail Response","properties":{"evtNo":{"type":"string","description":"Event No."},"evtNm":{"type":"string","description":"Event Name"},"evtLgrpCd":{"type":"string","description":"Event Type Major Category Code (EV001)"},"evtMgrpCd":{"type":"string","description":"Event Type Subcategory Code (EV002)"},"evtExpNmCd":{"type":"string","description":"Event Display Name Code (EV003)"},"evtObjCd":{"type":"string","description":"Event Purpose (EV004)"},"evtSbscPsbCd":{"type":"string","description":"Event Entry Eligibility Code (EV006)"},"sbscCntLmtCd":{"type":"string","description":"Number of Entries (EV007)"},"evtPrgsStatCd":{"type":"string","description":"Management Status (EV005)"},"evtStrDtm":{"type":"string","format":"date-time","description":"Event Start Date"},"evtEndDtm":{"type":"string","format":"date-time","description":"Event End Date"},"buyStrDtm":{"type":"string","format":"date-time","description":"Purchase Period Start Date"},"buyEndDtm":{"type":"string","format":"date-time","description":"Purchase Period End Date"},"sbscAplyStrDtm":{"type":"string","format":"date-time","description":"Application Period Start Date"},"sbscAplyEndDtm":{"type":"string","format":"date-time","description":"Application Period End Date"},"lotDt":{"type":"string","description":"Drawing/Confirmation Date"},"winAncmDt":{"type":"string","description":"Winner Announcement Date/Time"},"winAncmDispYn":{"type":"string","description":"Winner Announcement Display"},"pmgdSndDt":{"type":"string","description":"Gift Shipment Date"},"payDt":{"type":"string","description":"Point Payout Date/Time"},"evtUrlAddr":{"type":"string","description":"Event URL"},"evtBnrPathNm":{"type":"string","description":"Event Banner Path"},"evtBnrFileNm":{"type":"string","description":"Event Banner File Name"},"evtBnrAltCont":{"type":"string","description":"Event Banner Image Alt Text"},"pcEvtBnrPathNm":{"type":"string","description":"PC Event Banner Path Name"},"pcEvtBnrFileNm":{"type":"string","description":"PC Event Banner File Name"},"pcEvtBnrAltCont":{"type":"string","description":"PC Event Banner Image Alt Text"},"dispYn":{"type":"string","default":"Y","description":"Display Status"},"expYn":{"type":"string","description":"Exposure Status"},"evtSchTag":{"type":"string","description":"Event Search Tag"},"indInfoMkusAgrYn":{"type":"string","description":"Personal Information Usage Consent Status"},"indInfoMkusAgmt":{"type":"string","description":"Personal Information Usage Terms"},"indInfoThprPofAgrYn":{"type":"string","description":"Personal Information Third-Party Provision Consent Status"},"indInfoThprPofAgmt":{"type":"string","description":"Personal Information Third-Party Provision Terms"},"tubaDptStrDt":{"type":"string","description":"Withholding Tax Deposit Start Date/Time"},"tubaDptEndDt":{"type":"string","description":"Withholding Tax Deposit End Date/Time"},"evtTmplUseYn":{"type":"string","description":"Event Template Usage Status"},"evtTrgmnGbCd":{"type":"string","description":"Event Target Classification Code (EV012)"},"mbrGbCdList":{"type":"array","description":"Entry Member Category","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"mbrGradeCdList":{"type":"array","description":"Entry Member Grade","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"newEventList":{"type":"array","description":"Latest 4 Events","items":{"$ref":"#/components/schemas/EventInfoDetailResponse"}},"attenList":{"type":"array","description":"Attendance Check List","items":{"$ref":"#/components/schemas/AttenResponse"}},"attenCount":{"type":"integer","format":"int32","description":"Attendance Count"},"quizList":{"type":"array","description":"Quiz List","items":{"$ref":"#/components/schemas/CcEvtQuestInfoResponse"}},"pmgdList":{"type":"array","description":"Prize List","items":{"$ref":"#/components/schemas/CcEvtFvrInfoResponse"}},"tmplRelInfoList":{"type":"array","description":"Event Template Relationship Information List","items":{"$ref":"#/components/schemas/CcEvtTmplRelInfo"}},"tmplDtlInfoList":{"type":"array","description":"Event Template Detail Information List","items":{"$ref":"#/components/schemas/CcEvtTmplDtlInfoResponse"}},"evtExpMsg":{"type":"string","description":"Event Display Message"},"atndMtr":{"type":"string","description":"Precautions"},"custCntrGdWrdCont":{"type":"string","description":"Customer Center Guide Message Content"},"replyTotalCount":{"type":"integer","format":"int32","description":"Total Comment Count"},"replyList":{"type":"array","description":"All Event Comment List","items":{"$ref":"#/components/schemas/CcEvtBbInfoResponse"}},"myReplyList":{"type":"array","description":"My Event Comment List","items":{"$ref":"#/components/schemas/CcEvtMyBbInfoResponse"}},"attendanceList":{"type":"array","description":"Attendance","items":{"$ref":"#/components/schemas/CcEvtBbInfoResponse"}},"orderList":{"type":"array","description":"Order History","items":{"$ref":"#/components/schemas/EventMemberOrderGoodsDtlResponse"}},"totOrdAmt":{"type":"integer","format":"int64","description":"Total Order Amount"},"sbscPsbMinOrdAmt":{"type":"integer","format":"int32","description":"Minimum Entry Eligible Amount"},"evtSbscAplyYn":{"type":"string","description":"Event Entry Application Status"},"resultCd":{"type":"string","description":"Result Code"},"resultMsg":{"type":"string","description":"Result Message"},"acdnUseYn":{"type":"string","description":"Accordion Usage Status"}}},"CcEvtAplyGradeInfo":{"type":"object","description":"Event Applicable Grade Information","properties":{"evtNo":{"type":"string","description":"Event No."},"expGradeGbCd":{"type":"string","description":"Exposure Grade Type Code (EV018) [10: Entrant Management Code, 20: Entrant Grade Code]"},"expTgtNo":{"type":"string","description":"Exposure Target No. (ME002, ME008)\n* `ME002` : [ 10 : Integrated Member, 20 : General Member, 30 : Social Member, 99 : Non-Member ]

\n* `ME008` : [ 10 : GREEN, 20 : FAMILY, 30 : GOLD, 40 : VIP, 50 : VVIP ]

\n"}}},"EventInfoDetailResponse":{"type":"object","description":"Event List Detail Response","properties":{"evtNo":{"type":"string","description":"Event No."},"evtNm":{"type":"string","description":"Event Name"},"uprFixYn":{"type":"string","description":"Pinned Status"},"evtObjCd":{"type":"string","description":"Event Purpose (EV004)"},"evtLgrpCd":{"type":"string","description":"Event Type Major Category Code (EV001)"},"evtMgrpCd":{"type":"string","description":"Event Type Subcategory Code (EV002)"},"evtExpNmCd":{"type":"string","description":"Event Display Name Code (EV003)"},"sbscCntLmtCd":{"type":"string","description":"Number of Entries (EV007)"},"evtPrgsStatCd":{"type":"string","description":"Management Status (EV005)"},"evtStrDtm":{"type":"string","format":"date-time","description":"Event Start Date"},"evtEndDtm":{"type":"string","format":"date-time","description":"Event End Date"},"buyStrDtm":{"type":"string","format":"date-time","description":"Purchase Period Start Date"},"buyEndDtm":{"type":"string","format":"date-time","description":"Purchase Period End Date"},"sbscAplyStrDtm":{"type":"string","format":"date-time","description":"Application Period Start Date"},"sbscAplyEndDtm":{"type":"string","format":"date-time","description":"Application Period End Date"},"evtUrlAddr":{"type":"string","description":"Event URL"},"evtBnrPathNm":{"type":"string","description":"Event Banner Path"},"evtBnrFileNm":{"type":"string","description":"Event Banner File Name"},"evtBnrAltCont":{"type":"string","description":"Event Banner Image Alt Text"},"pcEvtBnrPathNm":{"type":"string","description":"PC Event Banner Path"},"pcEvtBnrFileNm":{"type":"string","description":"PC Event Banner File Name"},"pcEvtBnrAltCont":{"type":"string","description":"PC Event Banner Image Alt Text"},"dispYn":{"type":"string","default":"Y","description":"Display Status"},"expYn":{"type":"string","description":"Exposure Status"},"evtSchTag":{"type":"string","description":"Event Search Tag"},"evtTrgmnGbCd":{"type":"string","description":"Event Target Classification Code (EV012)"},"mbrGbCdList":{"type":"array","description":"Entry Member Category","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"mbrGradeCdList":{"type":"array","description":"Entry Member Grade","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"dispMbrGradeList":{"type":"array","description":"Display Membership Grade","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}}}},"AttenResponse":{"type":"object","description":"Attendance Reward Response","properties":{"evtNo":{"type":"string","description":"Event No."},"aplyRnk":{"type":"integer","format":"int32","description":"Applied Priority"},"payPoint":{"type":"integer","format":"int32","description":"Points Awarded"}}},"CcEvtQuestInfoResponse":{"type":"object","description":"Event Question Information Response","properties":{"evtNo":{"type":"string","description":"Event No."},"questNo":{"type":"string","description":"Question No."},"questGbCd":{"type":"string","description":"Question Type Code (EV017)"},"questCont":{"type":"string","description":"Question Details"},"questQestCnt":{"type":"integer","format":"int32","description":"Number of Questions"},"cawrCont":{"type":"string","description":"Correct Answer Content"},"dupAnsYn":{"type":"string","description":"Multiple Answers Status"},"mdtyQuestYn":{"type":"string","description":"Required Question Status"},"ansNo":{"type":"string","description":"Response No."},"cawrYn":{"type":"string","description":"Correct Answer Status"},"questAnsCont":{"type":"string","description":"Question and Answer Content"},"questExpltList":{"type":"array","description":"Survey View Information","items":{"$ref":"#/components/schemas/CcEvtQuestExplInfo"}},"quizExpltList":{"type":"array","description":"Quiz View Information","items":{"$ref":"#/components/schemas/CcEvtQuestExplInfo"}}}},"CcEvtQuestExplInfo":{"type":"object","description":"Event Question View Information","properties":{"evtNo":{"type":"string","description":"Event No."},"questNo":{"type":"string","description":"Question No."},"questExplNo":{"type":"string","description":"Question View No."},"questExplCont":{"type":"string","description":"Question View Content"},"questBnrPathNm":{"type":"string","description":"Question Banner Path Name"},"questBnrFileNm":{"type":"string","description":"Question Banner File Name"}}},"CcEvtFvrInfoResponse":{"type":"object","description":"Event Benefit Information Response","properties":{"evtNo":{"type":"string","description":"Event No."},"evtFvrSeq":{"type":"string","description":"Event Benefit Sequence No."},"winRnk":{"type":"integer","format":"int32","description":"Winning Rank"},"evtFvrTypCd":{"type":"string","description":"Event Benefit Type Code (EV011)"},"evtFvrTypNm":{"type":"string","description":"Event Benefit Type Code Name"},"buyAmt":{"type":"integer","format":"int32","description":"Purchase Amount"},"payMilg":{"type":"integer","format":"int32","description":"Mileage Payout"},"evtGoodsNm":{"type":"string","description":"Event Product Name"},"promoNo":{"type":"string","description":"Promotion No."},"goodsNo":{"type":"string","description":"Product No."},"goodsImg":{"type":"string","description":"Product Image"},"payPnumCnt":{"type":"integer","format":"int32","description":"Number of Recipients"},"pmgdAmt":{"type":"integer","format":"int32","description":"Prize Amount"},"winmnChrgYn":{"type":"string","description":"Winner Cost-Bearing Status"},"tuba":{"type":"integer","format":"int32","description":"Withholding Tax"},"winWtpsCnt":{"type":"integer","format":"int32","description":"Number of Winners on Waitlist"},"evetTermDesc":{"type":"string","description":"Event Period Description"},"evetCondDesc":{"type":"string","description":"Event Condition Description"},"etcDesc1":{"type":"string","description":"Other Description 1"},"etcDesc2":{"type":"string","description":"Other Description 2"},"etcDesc3":{"type":"string","description":"Other Description 3"},"etcDesc4":{"type":"string","description":"Other Description 4"},"etcDesc5":{"type":"string","description":"Other Description 5"},"paysTermDesc":{"type":"string","description":"Payout Period Description"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"paysYn":{"type":"string","description":"Prize Payment Status"}}},"CcEvtTmplRelInfo":{"type":"object","description":"Event Template Relation Information","properties":{"evtNo":{"type":"string","description":"Event No."},"evtTmplRelNo":{"type":"string","description":"Event Template Relation No."},"tmplNo":{"type":"string","description":"Template No."},"tmplDtlGbCd":{"type":"string","description":"Template Detail Type Code (EV014)\n* `Free Composition` : \"01\"

\n* `Bulletin Board` : \"02\"

\n* `FAQ` : \"03\"

\n"},"tmplDtlCmpsCd":{"type":"string","description":"Template Detail Composition Code (EV016)\n* `HTML Editor` : \"11\"

\n* `One-line Comment` : \"21\"

\n* `Attendance Check` : \"22\"

\n* `FAQ` : \"23\"

\n* `Post` : \"24\"

\n"},"tmplDtlSeq":{"type":"string","description":"Template Detail Sequence No."},"htmlFileCont":{"type":"string","description":"MOBILE HTML File Content"},"pcHtmlFileCont":{"type":"string","description":"PC HTML File Content"}}},"CcEvtTmplDtlInfoResponse":{"type":"object","description":"Event Detail Template Information Response","properties":{"tmplNo":{"type":"string","description":"Template No."},"tmplDtlGbCd":{"type":"string","description":"Template Detail Classification Code (EV014)"},"tmplDtlSeq":{"type":"string","description":"Template Detail Sequence No."},"tmplDtlCmpsCd":{"type":"string","description":"Template Detail Configuration Code (EV016)"},"tmplPrioRnk":{"type":"string","description":"Template Priority"},"htmlFileCont":{"type":"string","description":"MOBILE HTML File Content"},"pcHtmlFileCont":{"type":"string","description":"PC HTML File Content"}}},"CcEvtBbInfoResponse":{"type":"object","description":"Event Bulletin Board Information Response","properties":{"bbcNo":{"type":"string","description":"Post Number"},"evtNo":{"type":"string","description":"Event No."},"evtTmplRelNo":{"type":"string","description":"Event Template Relation No."},"evtBbGbCd":{"type":"string","description":"Event Bulletin Board Type Code (EV023)"},"bbcTitleNm":{"type":"string","description":"Post Title Name"},"bbcCont":{"type":"string","description":"Post Content"},"wrtmnNm":{"type":"string","description":"Author Name"},"wrtmnEmailAddr":{"type":"string","description":"Author Email Address"},"mbrNo":{"type":"string","description":"Member No."},"goodsNo":{"type":"string","description":"Product No."},"dispSeq":{"type":"integer","format":"int32","description":"Display Order"},"qryCnt":{"type":"integer","format":"int32","description":"View Count"},"recomCnt":{"type":"integer","format":"int32","description":"Recommendation Count"},"dispYn":{"type":"string","default":"Y","description":"Display Status"},"pblYn":{"type":"string","description":"Public Status"},"delYn":{"type":"string","description":"Deletion Status"},"regDt":{"type":"string","description":"Registration Date"},"mbrNm":{"type":"string","description":"Member Name"},"loginId":{"type":"string","description":"Member ID"}}},"CcEvtMyBbInfoResponse":{"type":"object","description":"Event Comment Information Response","properties":{"bbcNo":{"type":"string","description":"Post Number"},"evtNo":{"type":"string","description":"Event No."},"evtTmplRelNo":{"type":"string","description":"Event Template Relation No."},"evtBbGbCd":{"type":"string","description":"Event Bulletin Board Type Code (EV023)"},"bbcTitleNm":{"type":"string","description":"Post Title Name"},"bbcCont":{"type":"string","description":"Post Content"},"wrtmnNm":{"type":"string","description":"Author Name"},"wrtmnEmailAddr":{"type":"string","description":"Author Email Address"},"mbrNo":{"type":"string","description":"Member No."},"goodsNo":{"type":"string","description":"Product No."},"dispSeq":{"type":"integer","format":"int32","description":"Display Order"},"qryCnt":{"type":"integer","format":"int32","description":"View Count"},"recomCnt":{"type":"integer","format":"int32","description":"Recommendation Count"},"dispYn":{"type":"string","description":"Display Status"},"pblYn":{"type":"string","description":"Public Status"},"delYn":{"type":"string","description":"Deletion Status"},"regDt":{"type":"string","description":"Registration Date"},"mbrNm":{"type":"string","description":"Member Name"},"loginId":{"type":"string","description":"Member ID"}}},"EventMemberOrderGoodsDtlResponse":{"type":"object","description":"Order Information Detail Response","properties":{"ordNo":{"type":"string","description":"Order No."},"ordDtm":{"type":"string","format":"date-time","description":"Order Date"},"ordAmt":{"type":"integer","format":"int64","description":"Order Amount"}}},"Response":{"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":{"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"}}}}}} ``` ## Retrieve Event Customer Review (Survey) List > \## Function Description\ > \* This is the basic API for retrieving the event customer review (survey) list.\ > \---\ > \## Detailed Description\ > \* Retrieves only customer review (survey) events.\ > \* There is no pinned-at-top setting.\ > \* Sort order\ > \* Based on the event start date\ > \## Revision History\ > \* Release v2.00\_240425: Added site number to the event list search conditions
```json {"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/marketing/getCustReviewList":{"get":{"tags":["Event Lookup"],"summary":"Retrieve Event Customer Review (Survey) List","description":"## Function Description\n* This is the basic API for retrieving the event customer review (survey) list.\n---\n## Detailed Description\n* Retrieves only customer review (survey) events.\n* There is no pinned-at-top setting.\n* Sort order\n* Based on the event start date\n## Revision History\n* Release v2.00_240425: Added site number to the event list search conditions\n","operationId":"getCustReviewList","parameters":[{"name":"siteNo","in":"query","description":"Site No.","schema":{"type":"string","description":"string"}},{"name":"pageIdx","in":"query","description":"Current Page","required":true,"schema":{"type":"string","description":"string"}},{"name":"rowsPerPage","in":"query","description":"Rows per Page","required":true,"schema":{"type":"string","description":"string"}},{"name":"myQuestViewYn","in":"query","description":"View Participated Survey","schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Customer review (survey) list retrieved successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EventSurveyResponse"}}}},"900":{"description":"Failed to retrieve customer review (survey) list","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EventSurveyResponse":{"type":"object","description":"Event Survey List Response","properties":{"allPageCnt":{"type":"integer","format":"int32","description":"Total Page Count"},"curPageNo":{"type":"integer","format":"int32","description":"Current Page No."},"evtBaseInfo":{"type":"array","description":"Event Detail","items":{"$ref":"#/components/schemas/EventSurveyDetailResponse"}}}},"EventSurveyDetailResponse":{"type":"object","description":"Event Survey List Detail Response","properties":{"evtNo":{"type":"string","description":"Event No."},"evtNm":{"type":"string","description":"Event Name"},"evtPrgsStatCd":{"type":"string","description":"Management Status (EV005)"},"evtStrDtm":{"type":"string","format":"date-time","description":"Event Start Date/Time"},"evtEndDtm":{"type":"string","format":"date-time","description":"Event End Date/Time"},"sbscAplyStrDtm":{"type":"string","format":"date-time","description":"Application Period Start Date"},"sbscAplyEndDtm":{"type":"string","format":"date-time","description":"Application Period End Date"},"evtSbscAplyYn":{"type":"string","description":"Participation Status"}}},"Response":{"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":{"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"}}}}}} ``` ## Retrieve Event Customer Review (Survey) Details > \## Function Description\ > \* This is the basic API for retrieving event customer review (survey) details.\ > \---\ > \## Detailed Description\ > \* Retrieves survey details using the event number as a parameter.\ > \* For logged-in users, checks whether they have submitted an entry.\ > \* For logged-in users, displays the questions and answers.\ > \## Revision History\ > \* Release v2.00\_240425: Added site number to the event detail retrieval and latest event list search conditions
```json {"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/marketing/getCustReviewDetail":{"get":{"tags":["Event Lookup"],"summary":"Retrieve Event Customer Review (Survey) Details","description":"## Function Description\n* This is the basic API for retrieving event customer review (survey) details.\n---\n## Detailed Description\n* Retrieves survey details using the event number as a parameter.\n* For logged-in users, checks whether they have submitted an entry.\n* For logged-in users, displays the questions and answers.\n## Revision History\n* Release v2.00_240425: Added site number to the event detail retrieval and latest event list search conditions\n","operationId":"getCustReviewDetail","parameters":[{"name":"siteNo","in":"query","description":"Site No.","schema":{"type":"string","description":"string"}},{"name":"evtNo","in":"query","description":"Event No.","required":true,"schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Customer review (survey) details retrieved successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EventSurveyInfoResponse"}}}},"900":{"description":"Failed to retrieve customer review (survey) details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EventSurveyInfoResponse":{"type":"object","description":"Event Survey Response","properties":{"evtNo":{"type":"string","description":"Event No."},"evtNm":{"type":"string","description":"Event Name"},"evtPrgsStatCd":{"type":"string","description":"Management Status (EV005)"},"evtStrDtm":{"type":"string","format":"date-time","description":"Event Start Date/Time"},"evtEndDtm":{"type":"string","format":"date-time","description":"Event End Date/Time"},"sbscAplyStrDtm":{"type":"string","format":"date-time","description":"Application Period Start Date"},"sbscAplyEndDtm":{"type":"string","format":"date-time","description":"Application Period End Date"},"evtSbscAplyYn":{"type":"string","description":"Event Entry Application Status"},"questList":{"type":"array","description":"Survey List","items":{"$ref":"#/components/schemas/CcEvtQuestInfoResponse"}},"tmplRelInfoList":{"type":"array","description":"Event Template Relationship Information List","items":{"$ref":"#/components/schemas/CcEvtTmplRelInfo"}},"tmplDtlInfoList":{"type":"array","description":"Event Template Detail Information List","items":{"$ref":"#/components/schemas/CcEvtTmplDtlInfoResponse"}},"ansList":{"type":"array","description":"Answer List","items":{"$ref":"#/components/schemas/CcEvtQuestInfoResponse"}}}},"CcEvtQuestInfoResponse":{"type":"object","description":"Event Question Information Response","properties":{"evtNo":{"type":"string","description":"Event No."},"questNo":{"type":"string","description":"Question No."},"questGbCd":{"type":"string","description":"Question Type Code (EV017)"},"questCont":{"type":"string","description":"Question Details"},"questQestCnt":{"type":"integer","format":"int32","description":"Number of Questions"},"cawrCont":{"type":"string","description":"Correct Answer Content"},"dupAnsYn":{"type":"string","description":"Multiple Answers Status"},"mdtyQuestYn":{"type":"string","description":"Required Question Status"},"ansNo":{"type":"string","description":"Response No."},"cawrYn":{"type":"string","description":"Correct Answer Status"},"questAnsCont":{"type":"string","description":"Question and Answer Content"},"questExpltList":{"type":"array","description":"Survey View Information","items":{"$ref":"#/components/schemas/CcEvtQuestExplInfo"}},"quizExpltList":{"type":"array","description":"Quiz View Information","items":{"$ref":"#/components/schemas/CcEvtQuestExplInfo"}}}},"CcEvtQuestExplInfo":{"type":"object","description":"Event Question View Information","properties":{"evtNo":{"type":"string","description":"Event No."},"questNo":{"type":"string","description":"Question No."},"questExplNo":{"type":"string","description":"Question View No."},"questExplCont":{"type":"string","description":"Question View Content"},"questBnrPathNm":{"type":"string","description":"Question Banner Path Name"},"questBnrFileNm":{"type":"string","description":"Question Banner File Name"}}},"CcEvtTmplRelInfo":{"type":"object","description":"Event Template Relation Information","properties":{"evtNo":{"type":"string","description":"Event No."},"evtTmplRelNo":{"type":"string","description":"Event Template Relation No."},"tmplNo":{"type":"string","description":"Template No."},"tmplDtlGbCd":{"type":"string","description":"Template Detail Type Code (EV014)\n* `Free Composition` : \"01\"

\n* `Bulletin Board` : \"02\"

\n* `FAQ` : \"03\"

\n"},"tmplDtlCmpsCd":{"type":"string","description":"Template Detail Composition Code (EV016)\n* `HTML Editor` : \"11\"

\n* `One-line Comment` : \"21\"

\n* `Attendance Check` : \"22\"

\n* `FAQ` : \"23\"

\n* `Post` : \"24\"

\n"},"tmplDtlSeq":{"type":"string","description":"Template Detail Sequence No."},"htmlFileCont":{"type":"string","description":"MOBILE HTML File Content"},"pcHtmlFileCont":{"type":"string","description":"PC HTML File Content"}}},"CcEvtTmplDtlInfoResponse":{"type":"object","description":"Event Detail Template Information Response","properties":{"tmplNo":{"type":"string","description":"Template No."},"tmplDtlGbCd":{"type":"string","description":"Template Detail Classification Code (EV014)"},"tmplDtlSeq":{"type":"string","description":"Template Detail Sequence No."},"tmplDtlCmpsCd":{"type":"string","description":"Template Detail Configuration Code (EV016)"},"tmplPrioRnk":{"type":"string","description":"Template Priority"},"htmlFileCont":{"type":"string","description":"MOBILE HTML File Content"},"pcHtmlFileCont":{"type":"string","description":"PC HTML File Content"}}},"Response":{"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":{"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"}}}}}} ```