> 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).

# 이벤트 조회 팝업&#x20;

## 이벤트 관리 목록 조회

> \## 기능 설명\
> \* 이벤트 정보 관리 - 그리드 목록, 목록 수를 조회한다.\
> \---\
> \## 상세 설명\
> \* 필수값 없습니다.\
> \* \*\*조회기간(startDate/EndDate) , 사이트번호(siteNo) , 이벤트번호/명(evtNo) , 이벤트유형(evtTyp) , 관리상태(evtPrgsStat) , 전시여부(dispYn) , 최상단 고정여부(upFixYn) , 진행부서(deptCd) , 담당자(aempId)\*\*\
> \* 위 파라미터로 넘겨받아 조건에 해당하는 데이터 목록, 목록 수를 조회 합니다.\
> \* 정렬조건\
> &#x20;   \* 이벤트 등록일시 순\
> \---\
> \## 수정번호\
> \* 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"}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tech.x2bee.com/api/back-office-api/popup-bo-api/undefined-8.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.