> 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/back-office-api/popup-bo-api/undefined-8.md).

# 이벤트 조회 팝업

## 이벤트 관리 목록 조회

> \## 기능 설명\
> \* 이벤트 정보 관리 - 그리드 목록, 목록 수를 조회한다.\
> \---\
> \## 상세 설명\
> \* 필수값 없습니다.\
> \* \*\*조회기간(startDate/EndDate) , 사이트번호(siteNo) , 이벤트번호/명(evtNo) , 이벤트유형(evtTyp) , 관리상태(evtPrgsStat) , 전시여부(dispYn) , 최상단 고정여부(upFixYn) , 진행부서(deptCd) , 담당자(aempId)\*\*\
> \* 위 파라미터로 넘겨받아 조건에 해당하는 데이터 목록, 목록 수를 조회 합니다.\
> \* 정렬조건\
>     \* 이벤트 등록일시 순\
> \---\
> \## 수정번호\
> \* Release v2.00\_240425: 목록 조회 조건 및 결과에 사이트 정보 추가\
> \* Release v2.00\_240530: 날짜조회 쿼리 변경<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":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"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":"부모창 그리드 조회 구분값"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrEmail":{"type":"string","description":"회원 이메일"},"mbrAddr":{"type":"string","description":"회원 주소"},"mbrTel":{"type":"integer","format":"int32","description":"회원 전화번호"},"evtTypNm":{"type":"string","description":"이벤트유형명"},"evtNo":{"type":"string","description":"이벤트번호"},"evtNm":{"type":"string","description":"이벤트명"},"uprFixYn":{"type":"string","description":"최상단여부"},"evtLgrpCd":{"type":"string","description":"이벤트유형 대분류코드(EV001)","enum":["MAIN_CATEGORY_LOTTERY","MAIN_CATEGORY_NOT_LOTTERY"]},"evtMgrpCd":{"type":"string","description":"이벤트유형 중분류코드(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":"이벤트노출명코드(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":"이벤트목적(EV004)","enum":["EVT_PURPOSE_RE","EVT_PURPOSE_ADD","EXPOSURE_NAME_NEW_MEMBER"]},"evtSbscPsbCd":{"type":"string","description":"이벤트응모가능코드(EV006)","enum":["APPLICATION_ALL","APPLICATION_PC","APPLICATION_MO"]},"evtGbCd":{"type":"string","description":"이벤트구분코드(EV026)","enum":["EVT_CLASSIFICATION_NOMAL","EVT_CLASSIFICATION_BRAND","EVT_CLASSIFICATION_ALLIANCE"]},"sbscCntLmtCd":{"type":"string","description":"응모횟수(EV007)","enum":["EVT_COUNT_DAY","EVT_COUNT_TERM","EVT_COUNT_NO_LIMIT"]},"deptCd":{"type":"string","description":"진행부서 코드"},"deptNm":{"type":"string","description":"진행부서 명"},"evtPrgsStatCd":{"type":"string","description":"이벤트진행상태코드(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":"구매금액이벤트프로모션여부"},"evetTermDesc":{"type":"string","description":"행사기간설명"},"evetCondDesc":{"type":"string","description":"행사조건설명"},"paysTermDesc":{"type":"string","description":"지급기간설명"},"lotDt":{"type":"string","description":"추첨/확정일자"},"winAncmDt":{"type":"string","description":"당첨발표일시"},"winAncmDispYn":{"type":"string","description":"당첨발표전시"},"pmgdSndDt":{"type":"string","description":"사은품 발송일"},"payDt":{"type":"string","description":"포인트지급일시"},"evtUrlAddr":{"type":"string","description":"이벤트URL주소"},"evtBnrPathNm":{"type":"string","description":"이벤트배너경로명"},"evtBnrFileNm":{"type":"string","description":"이벤트배너파일명"},"evtBnrAltCont":{"type":"string","description":"이벤트배너이미지 대체텍스트"},"pcEvtBnrPathNm":{"type":"string","description":"이벤트배너경로명 pc용"},"pcEvtBnrFileNm":{"type":"string","description":"이벤트배너파일명 pc용"},"pcEvtBnrAltCont":{"type":"string","description":"이벤트배너이미지 PC용 대체텍스트"},"aempId":{"type":"string","description":"담당자 ID"},"aempNm":{"type":"string","description":"담당자 명"},"adveWrdCont":{"type":"string","description":"홍보문구내용"},"pmgdRcvProeCont":{"type":"string","description":"경품수령절차내용"},"dispYn":{"type":"string","description":"전시여부"},"expYn":{"type":"string","description":"노출여부"},"evtSchTag":{"type":"string","description":"이벤트검색태그"},"indInfoMkusAgrYn":{"type":"string","description":"개인정보이용동의여부"},"indInfoMkusAgmt":{"type":"string","description":"개인정보이용약관"},"indInfoThprPofAgrYn":{"type":"string","description":"개인정보제3자제공동의여부"},"indInfoThprPofAgmt":{"type":"string","description":"개인정보제3자제공약관"},"rnkMgrYn":{"type":"string","description":"순위관리여부"},"tubaDptStrDt":{"type":"string","description":"제세공과금입금시작일시"},"tubaDptEndDt":{"type":"string","description":"제세공과금입금종료일시"},"evtTmplUseYn":{"type":"string","description":"이벤트탬플릿사용여부"},"mbrGbCdList":{"type":"array","description":"회원구분리스트","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"mbrGradeCdList":{"type":"array","description":"회원등급리스트","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"dispMbrGradeList":{"type":"array","description":"전시회원등급리스트","items":{"$ref":"#/components/schemas/CcEvtAplyGradeInfo"}},"loltList":{"type":"array","description":"룰렛List","items":{"$ref":"#/components/schemas/CcEvtDetlItem"}},"attenList":{"type":"array","description":"출석체크List","items":{"$ref":"#/components/schemas/CcEvtDetlItem"}},"questList":{"type":"array","description":"설문LIst","items":{"$ref":"#/components/schemas/EvtQuestInfoResponse"}},"pmgdList":{"type":"array","description":"경품List","items":{"$ref":"#/components/schemas/CcEvtFvrInfoResponse"}},"tmplRelInfoList":{"type":"array","description":"이벤트템플릿관계정보 List","items":{"$ref":"#/components/schemas/CcEvtTmplRelInfo"}},"tmplDtlInfoList":{"type":"array","description":"이벤트템플릿상세정보 List","items":{"$ref":"#/components/schemas/CcEvtTmplDtlInfoResponse"}},"evtExpMsg":{"type":"string","description":"이벤트 노출 메시지"},"atndMtr":{"type":"string","description":"유의사항"},"acdnUseYn":{"type":"string","description":"아코디언 UI 사용유무"},"custCntrGdWrdCont":{"type":"string","description":"고객센터안내문구내용"},"sbscAplyDtm":{"type":"string","format":"date-time","description":"응모신청일시"},"evtStrDtm":{"type":"string","format":"date-time","description":"이벤트시작일시"},"evtEndDtm":{"type":"string","format":"date-time","description":"이벤트종료일시"},"buyStrDtm":{"type":"string","format":"date-time","description":"구매기간시작일"},"buyEndDtm":{"type":"string","format":"date-time","description":"구매기간종료일"},"sbscAplyStrDtm":{"type":"string","format":"date-time","description":"응모/신청기간시작일"},"sbscAplyEndDtm":{"type":"string","format":"date-time","description":"응모/신청기간종료일"},"sbscPsbMinOrdAmt":{"type":"number","description":"응모 최소 주문결제 금액"},"siteNm":{"type":"string","description":"사이트명"},"aplySites":{"type":"array","items":{"type":"object","additionalProperties":{"type":"string"},"description":"적용 조건 - 사이트"}}}},"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":"이벤트번호"},"questNo":{"type":"string","description":"질문번호"},"questGbCd":{"type":"string","description":"질문구분코드(EV017)","enum":["OBJECTIVE_TYPE","OBJECTIVE_TYPE_ETC","OBJECTIVE_TYPE_IMAGE","SUBJECTIVE","SCALE_TYPE"]},"questCont":{"type":"string","description":"질문내용"},"questQestCnt":{"type":"integer","format":"int32","description":"질문문항수"},"cawrCont":{"type":"string","description":"정답내용"},"dupAnsYn":{"type":"string","description":"복수답변여부"},"mdtyQuestYn":{"type":"string","description":"필수질문여부"},"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":"이벤트번호"},"evtFvrSeq":{"type":"string","description":"이벤트혜택순번"},"winRnk":{"type":"integer","format":"int32","description":"당첨순위"},"evtFvrTypCd":{"type":"string","description":"이벤트혜택유형코드(EV011)","enum":["GIFTS","GIVEAWAY","MILEAGE","COUPON"]},"evtFvrTypNm":{"type":"string","description":"이벤트혜택유형코드명"},"buyAmt":{"type":"integer","format":"int32","description":"구매금액"},"payMilg":{"type":"integer","format":"int32","description":"지급마일리지"},"evtGoodsNm":{"type":"string","description":"이벤트상품명"},"promoNo":{"type":"string","description":"프로모션번호"},"goodsNo":{"type":"string","description":"상품번호"},"payPnumCnt":{"type":"integer","format":"int32","description":"지급인원수"},"pmgdAmt":{"type":"integer","format":"int32","description":"경품금액"},"winmnChrgYn":{"type":"string","description":"당첨자부담여부"},"tuba":{"type":"integer","format":"int32","description":"제세공과금"},"winWtpsCnt":{"type":"integer","format":"int32","description":"당첨대기자수"},"etcDesc1":{"type":"string","description":"기타설명1"},"etcDesc2":{"type":"string","description":"기타설명2"},"etcDesc3":{"type":"string","description":"기타설명3"},"etcDesc4":{"type":"string","description":"기타설명4"},"etcDesc5":{"type":"string","description":"기타설명5"},"trgmnCount":{"type":"integer","format":"int32","description":"현재당첨인원"},"doingYn":{"type":"string","description":"당첨진행여부"},"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":"템플릿번호"},"tmplDtlGbCd":{"type":"string","description":"템플릿상세구분코드(EV014)","enum":["FREE_COMPOSITION","NOTICE_BOARD","FAQ"]},"tmplDtlSeq":{"type":"string","description":"템플릿상세순번"},"tmplDtlCmpsCd":{"type":"string","description":"템플릿상세구성코드(EV016)","enum":["HTML","ONE_LINE","ATTENDANCE","FAQ","POST","POST_COMMENT","POST_IMAGE","POST_COMMENT_IMAGE"]},"tmplPrioRnk":{"type":"string","description":"템플릿우선순위"},"htmlFileCont":{"type":"string","description":"HTML파일내용"},"pcHtmlFileCont":{"type":"string","description":"HTML파일내용_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"}}}}},"paths":{"/v2/popup/marketing/events":{"get":{"tags":["이벤트 조회 팝업 "],"summary":"이벤트 관리 목록 조회","description":"## 기능 설명\n* 이벤트 정보 관리 - 그리드 목록, 목록 수를 조회한다.\n---\n## 상세 설명\n* 필수값 없습니다.\n* **조회기간(startDate/EndDate) , 사이트번호(siteNo) , 이벤트번호/명(evtNo) , 이벤트유형(evtTyp) , 관리상태(evtPrgsStat) , 전시여부(dispYn) , 최상단 고정여부(upFixYn) , 진행부서(deptCd) , 담당자(aempId)**\n* 위 파라미터로 넘겨받아 조건에 해당하는 데이터 목록, 목록 수를 조회 합니다.\n* 정렬조건\n    * 이벤트 등록일시 순\n---\n## 수정번호\n* Release v2.00_240425: 목록 조회 조건 및 결과에 사이트 정보 추가\n* Release v2.00_240530: 날짜조회 쿼리 변경\n","operationId":"getEventList","parameters":[{"name":"evtNo","in":"query","description":"이벤트번호","schema":{"type":"string"}},{"name":"startDate","in":"query","description":"시작일","schema":{"type":"string"}},{"name":"endDate","in":"query","description":"마지막일","schema":{"type":"string"}},{"name":"evtLgrpCd","in":"query","description":"이벤트대분류코드","schema":{"type":"string"}},{"name":"evtTyp","in":"query","description":"이벤트유형","schema":{"type":"string"}},{"name":"evtNm","in":"query","description":"이벤트이름","schema":{"type":"string"}},{"name":"aempId","in":"query","description":"담당자ID","schema":{"type":"string"}},{"name":"deptCd","in":"query","description":"부서코드","schema":{"type":"string"}},{"name":"dispYn","in":"query","description":"전시여부","schema":{"type":"string"}},{"name":"evtPrgsStat","in":"query","description":"이벤트진행상태","schema":{"type":"string"}},{"name":"evtGbCd","in":"query","description":"이벤트구분코드","schema":{"type":"string"}},{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseCcEvtBaseResponse"}}}},"900":{"description":"실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```