> 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/back-office-api-reference/popup-bo-api/event-lookup-popup.md).

# Event Lookup Popup

## Retrieve Event Management List

> \## Function Description\
> \* Event Information Management - Retrieves the grid list and list count.\
> \---\
> \## Detailed Description\
> \* No required values.\
> \* \*\*Search Period (startDate/EndDate), Site No. (siteNo), Event No./Name (evtNo), Event Type (evtTyp), Management Status (evtPrgsStat), Display Status (dispYn), Top Fixed Status (upFixYn), Department in Charge (deptCd), Person in Charge (aempId)\*\*\
> \* Retrieves the data list and list count matching the conditions with the above parameters.\
> \* Sort Condition\
>     \* By event registration date/time\
> \---\
> \## Revision History\
> \* Release v2.00\_240425: Added site information to the list inquiry conditions and results\
> \* Release v2.00\_240530: Changed date inquiry query<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v2/popup/marketing/events":{"get":{"tags":["Event Lookup Popup"],"summary":"Retrieve Event Management List","description":"## Function Description\n* Event Information Management - Retrieves the grid list and list count.\n---\n## Detailed Description\n* No required values.\n* **Search Period (startDate/EndDate), Site No. (siteNo), Event No./Name (evtNo), Event Type (evtTyp), Management Status (evtPrgsStat), Display Status (dispYn), Top Fixed Status (upFixYn), Department in Charge (deptCd), Person in Charge (aempId)**\n* Retrieves the data list and list count matching the conditions with the above parameters.\n* Sort Condition\n    * By event registration date/time\n---\n## Revision History\n* Release v2.00_240425: Added site information to the list inquiry conditions and results\n* Release v2.00_240530: Changed date inquiry query\n","operationId":"getEventList","parameters":[{"name":"evtNo","in":"query","description":"Event No.","schema":{"type":"string"}},{"name":"startDate","in":"query","description":"Start Date","schema":{"type":"string"}},{"name":"endDate","in":"query","description":"Last Day","schema":{"type":"string"}},{"name":"evtLgrpCd","in":"query","description":"Event Major Category Code","schema":{"type":"string"}},{"name":"evtTyp","in":"query","description":"Event Type","schema":{"type":"string"}},{"name":"evtNm","in":"query","description":"Event Name","schema":{"type":"string"}},{"name":"aempId","in":"query","description":"Person in Charge ID","schema":{"type":"string"}},{"name":"deptCd","in":"query","description":"Department Code","schema":{"type":"string"}},{"name":"dispYn","in":"query","description":"Display Status","schema":{"type":"string"}},{"name":"evtPrgsStat","in":"query","description":"Event Progress Status","schema":{"type":"string"}},{"name":"evtGbCd","in":"query","description":"Event Classification Code","schema":{"type":"string"}},{"name":"siteNo","in":"query","description":"Site No.","schema":{"type":"string"}},{"name":"pageIdx","in":"query","description":"Current Page","required":true,"schema":{"type":"string"}},{"name":"rowsPerPage","in":"query","description":"Rows per Page","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseCcEvtBaseResponse"}}}},"900":{"description":"Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"RealGridListResponseCcEvtBaseResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/CcEvtBaseResponse"}}}},"CcEvtBaseResponse":{"type":"object","properties":{"reSearchPage":{"type":"string","description":"Parent Window Grid Search Type Value"},"mbrNo":{"type":"string","description":"Member No."},"mbrId":{"type":"string","description":"Member ID"},"mbrNm":{"type":"string","description":"Member Name"},"mbrEmail":{"type":"string","description":"Member Email"},"mbrAddr":{"type":"string","description":"Member Address"},"mbrTel":{"type":"integer","format":"int32","description":"Member Phone Number"},"evtTypNm":{"type":"string","description":"Event Type Name"},"evtNo":{"type":"string","description":"Event No."},"evtNm":{"type":"string","description":"Event Name"},"uprFixYn":{"type":"string","description":"Top Position Status"},"evtLgrpCd":{"type":"string","description":"Event Type Major Category Code (EV001)","enum":["MAIN_CATEGORY_LOTTERY","MAIN_CATEGORY_NOT_LOTTERY"]},"evtMgrpCd":{"type":"string","description":"Event Type Subcategory Code (EV002)","enum":["MIDDLE_CLASSIFICATION_LOTTERY","MIDDLE_CLASSIFICATION_PUR_COME","MIDDLE_CLASSIFICATION_AMOUNT","MIDDLE_CLASSIFICATION_STAMP","MIDDLE_CLASSIFICATION_CLICK","MIDDLE_CLASSIFICATION_ROULETTE","MIDDLE_CLASSIFICATION_ATTENDANCE","MIDDLE_CLASSIFICATION_SURVEY","MIDDLE_CLASSIFICATION_QUIZE","MIDDLE_CLASSIFICATION_COMMENT","MIDDLE_CLASSIFICATION_PURE","MIDDLE_CLASSIFICATION_COUPON","MIDDLE_CLASSIFICATION_ETC"]},"evtExpNmCd":{"type":"string","description":"Event Display Name Code (EV003)","enum":["EXPOSURE_NAME_PUR","EXPOSURE_NAME_RECEIPT","EXPOSURE_NAME_PUR_CERTI","EXPOSURE_NAME_VOTE","EXPOSURE_NAME_QUIZE","EXPOSURE_NAME_ETC"]},"evtObjCd":{"type":"string","description":"Event Purpose (EV004)","enum":["EVT_PURPOSE_RE","EVT_PURPOSE_ADD","EXPOSURE_NAME_NEW_MEMBER"]},"evtSbscPsbCd":{"type":"string","description":"Event Entry Eligibility Code (EV006)","enum":["APPLICATION_ALL","APPLICATION_PC","APPLICATION_MO"]},"evtGbCd":{"type":"string","description":"Event Type Code (EV026)","enum":["EVT_CLASSIFICATION_NOMAL","EVT_CLASSIFICATION_BRAND","EVT_CLASSIFICATION_ALLIANCE"]},"sbscCntLmtCd":{"type":"string","description":"Number of Entries (EV007)","enum":["EVT_COUNT_DAY","EVT_COUNT_TERM","EVT_COUNT_NO_LIMIT"]},"deptCd":{"type":"string","description":"Managing Department Code"},"deptNm":{"type":"string","description":"Organizing Department Name"},"evtPrgsStatCd":{"type":"string","description":"Event Progress Status Code (EV005)","enum":["TEMP_REG","PROGRESS","LOT_WAIT","SHOW_WAIT","TUBA_PROGRESS","PMGD_SND_WAIT","PMGD_SND_COMPLETE","PAYMENTS_WAIT","PAYMENTS_COMPLETE","CANCEL","EVT_END"]},"purAmtEvtPromoYn":{"type":"string","description":"Purchase Amount Event Promotion Status"},"evetTermDesc":{"type":"string","description":"Event Period Description"},"evetCondDesc":{"type":"string","description":"Event Condition Description"},"paysTermDesc":{"type":"string","description":"Payout Period Description"},"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":"Event Banner Path Name (PC)"},"pcEvtBnrFileNm":{"type":"string","description":"Event Banner File Name (PC)"},"pcEvtBnrAltCont":{"type":"string","description":"Event Banner Image Alt Text for PC"},"aempId":{"type":"string","description":"Person in Charge ID"},"aempNm":{"type":"string","description":"Manager Name"},"adveWrdCont":{"type":"string","description":"Promotional Text Content"},"pmgdRcvProeCont":{"type":"string","description":"Prize Receiving Procedure Content"},"dispYn":{"type":"string","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"},"rnkMgrYn":{"type":"string","description":"Ranking Management Status"},"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"},"mbrGbCdList":{"type":"array","description":"Member Classification List","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"mbrGradeCdList":{"type":"array","description":"Member Grade List","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"dispMbrGradeList":{"type":"array","description":"Display Member Grade List","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"loltList":{"type":"array","description":"Roulette List","items":{"$ref":"#/components/schemas/CcEvtDetlItem"}},"attenList":{"type":"array","description":"Attendance Check List","items":{"$ref":"#/components/schemas/CcEvtDetlItem"}},"questList":{"type":"array","description":"Survey List","items":{"$ref":"#/components/schemas/EvtQuestInfoResponse"}},"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"},"acdnUseYn":{"type":"string","description":"Accordion UI Usage Status"},"custCntrGdWrdCont":{"type":"string","description":"Customer Center Guide Message Content"},"sbscAplyDtm":{"type":"string","format":"date-time","description":"Application Date/Time"},"evtStrDtm":{"type":"string","format":"date-time","description":"Event Start Date/Time"},"evtEndDtm":{"type":"string","format":"date-time","description":"Event End Date/Time"},"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"},"sbscPsbMinOrdAmt":{"type":"number","description":"Minimum Order Payment Amount for Entry"},"siteNm":{"type":"string","description":"Site Name"},"aplySites":{"type":"array","items":{"type":"object","additionalProperties":{"type":"string"},"description":"Application Condition - Site"}}}},"CcEvtAplyGradeInfo":{"type":"object","properties":{"evtNo":{"type":"string"},"expGradeGbCd":{"type":"string"},"expTgtNo":{"type":"string"}}},"CcEvtDetlItem":{"type":"object","properties":{"evtNo":{"type":"string"},"evtMgrpCd":{"type":"string"},"aplyRnk":{"type":"integer","format":"int32"},"roltPayPnum":{"type":"integer","format":"int32"},"roltPrbl":{"type":"number","format":"float"},"payPoint":{"type":"integer","format":"int32"}}},"EvtQuestInfoResponse":{"type":"object","properties":{"evtNo":{"type":"string","description":"Event No."},"questNo":{"type":"string","description":"Question No."},"questGbCd":{"type":"string","description":"Question Type Code (EV017)","enum":["OBJECTIVE_TYPE","OBJECTIVE_TYPE_ETC","OBJECTIVE_TYPE_IMAGE","SUBJECTIVE","SCALE_TYPE"]},"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"},"questExpltList":{"type":"array","items":{"$ref":"#/components/schemas/CcEvtQuestExplInfo"}}}},"CcEvtQuestExplInfo":{"type":"object","properties":{"evtNo":{"type":"string"},"questNo":{"type":"string"},"questExplNo":{"type":"string"},"questExplCont":{"type":"string"},"questBnrPathNm":{"type":"string"},"questBnrFileNm":{"type":"string"}}},"CcEvtFvrInfoResponse":{"type":"object","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)","enum":["GIFTS","GIVEAWAY","MILEAGE","COUPON"]},"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."},"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"},"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"},"trgmnCount":{"type":"integer","format":"int32","description":"Current Number of Winners"},"doingYn":{"type":"string","description":"Winner Selection Progress Status"},"pcount":{"type":"integer","format":"int32"}}},"CcEvtTmplRelInfo":{"type":"object","properties":{"evtNo":{"type":"string"},"evtTmplRelNo":{"type":"string"},"tmplNo":{"type":"string"},"tmplDtlGbCd":{"type":"string"},"tmplDtlCmpsCd":{"type":"string"},"tmplDtlSeq":{"type":"string"},"htmlFileCont":{"type":"string"},"pcHtmlFileCont":{"type":"string"},"etcWrtCont":{"type":"string"},"wrtRtGbCd":{"type":"string"},"listPrtCntCd":{"type":"string"},"bkgrImgPathNm":{"type":"string"},"bkgrImgFileNm":{"type":"string"},"bbSharYn":{"type":"string"}}},"CcEvtTmplDtlInfoResponse":{"type":"object","properties":{"tmplNo":{"type":"string","description":"Template No."},"tmplDtlGbCd":{"type":"string","description":"Template Detail Classification Code (EV014)","enum":["FREE_COMPOSITION","NOTICE_BOARD","FAQ"]},"tmplDtlSeq":{"type":"string","description":"Template Detail Sequence No."},"tmplDtlCmpsCd":{"type":"string","description":"Template Detail Configuration Code (EV016)","enum":["HTML","ONE_LINE","ATTENDANCE","FAQ","POST","POST_COMMENT","POST_IMAGE","POST_COMMENT_IMAGE"]},"tmplPrioRnk":{"type":"string","description":"Template Priority"},"htmlFileCont":{"type":"string","description":"HTML File Content"},"pcHtmlFileCont":{"type":"string","description":"HTML File Content (PC)"}}},"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"}}}}}}
```