> 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/marketing-bo-api/undefined-5.md).

# 이벤트 설문 조회

## 이벤트 설문상세 조회

> \## 기능 설명\
> \* 설문 응모한 회원의 이벤트 설문상세를 조회합니다.\
> \---\
> \## 상세 설명\
> \* \*\*응모자번호(trgmnSeq) , 이벤트번호(evtNo)\*\*는 필수로 있어야 합니다.<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":{"EvtSurveyRequest":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트번호"},"periodGb":{"type":"string","description":"조회기간 선택"},"startDate":{"type":"string","format":"date","description":"응모기간 시작일자"},"endDate":{"type":"string","format":"date","description":"응모기간 종료일자"},"mbrNo":{"type":"string","description":"회원번호"},"trgmnSeq":{"type":"string","description":"대상자순번"},"evtNm":{"type":"string","description":"이벤트명"},"aempId":{"type":"string","description":"이벤트담당자"},"evtNo":{"type":"string","description":"이벤트번호"},"evtNoList":{"type":"array","description":"이벤트번호 LIST","items":{"type":"string"}},"dateSelect":{"type":"string","description":"날짜선택옵션"},"sbscAplyDtm":{"type":"string","format":"date-time","description":"응모신청일시"}}},"EvtSurveyDtlResponse":{"type":"object","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"trgmnSeq":{"type":"string","description":"대상자순번"},"questAnsList":{"type":"array","description":"이벤트질문답변정보","items":{"$ref":"#/components/schemas/CcEvtQuestAnsInfo"}},"questList":{"type":"array","description":"설문List","items":{"$ref":"#/components/schemas/EvtQuestInfoResponse"}}}},"CcEvtQuestAnsInfo":{"type":"object","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"trgmnSeq":{"type":"string","description":"대상자순번"},"questNo":{"type":"string","description":"질문번호"},"ansNo":{"type":"string","description":"답변번호"},"questAnsCont":{"type":"string","description":"질문답변내용"},"cawrYn":{"type":"string","description":"정답여부"}}},"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"}}},"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":{"/v1/marketing/eventSurvey/getEventSurveyDetail":{"post":{"tags":["이벤트 설문 조회"],"summary":"이벤트 설문상세 조회","description":"## 기능 설명\n* 설문 응모한 회원의 이벤트 설문상세를 조회합니다.\n---\n## 상세 설명\n* **응모자번호(trgmnSeq) , 이벤트번호(evtNo)**는 필수로 있어야 합니다.\n","operationId":"getEventSurveyDetail","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvtSurveyRequest"}}},"required":true},"responses":{"200":{"description":"설문 상세 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EvtSurveyDtlResponse"}}}},"900":{"description":"설문 상세 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 이벤트 설문 목록 조회

> \## 기능 설명\
> \* 이벤트 설문 목록을 조회합니다.\
> \---\
> \## 상세 설명\
> \* 필수값 없습니다.\
> \* \*\*조회기간(startDate/EndDate) , 사이트번호(siteNo) , 이벤트번호/명(evtNo) , 응모번호(trgmnSeq) , 회원번호(mbrNo) , 등록자(aempId)\*\*\
> \* 위 파라미터로 넘겨받아 조건에 해당하는 데이터를 조회 합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240425: 목록 조회 조건 및 결과에 사이트 정보 추가\
> \* Release v2.00\_240530: 날짜조회 쿼리 변경\
> \* Release v2.00\_250428: 날짜조회 쿼리 변경 - BO 선택 옵션 (3, 7, 30, 전체) 추가되어 전체인 경우 날짜 조건 제외<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":{"RealGridListResponseEvtSurveyResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/EvtSurveyResponse"}}}},"EvtSurveyResponse":{"type":"object","properties":{"qryGbCd":{"type":"string","description":"개인정보 조회구분코드(UR014) 10:조회,20:엑셀다운로드,30:수정"},"indInfoQryCaus":{"type":"string","description":"열람사유내용"},"evtNo":{"type":"string","description":"이벤트번호"},"evtNm":{"type":"string","description":"이벤트명"},"trgmnSeq":{"type":"string","description":"대상자순번"},"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"loginId":{"type":"string","description":"회원ID"},"aempNm":{"type":"string","description":"이벤트담당자"},"evtUrlAddr":{"type":"string","description":"이벤트 URL 주소"},"sbscAplyDtm":{"type":"string","format":"date-time","description":"응모신청일시"},"siteNm":{"type":"string","description":"사이트명"}}},"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/marketing/eventSurvey/getEventSurveyList":{"get":{"tags":["이벤트 설문 조회"],"summary":"이벤트 설문 목록 조회","description":"## 기능 설명\n* 이벤트 설문 목록을 조회합니다.\n---\n## 상세 설명\n* 필수값 없습니다.\n* **조회기간(startDate/EndDate) , 사이트번호(siteNo) , 이벤트번호/명(evtNo) , 응모번호(trgmnSeq) , 회원번호(mbrNo) , 등록자(aempId)**\n* 위 파라미터로 넘겨받아 조건에 해당하는 데이터를 조회 합니다.\n---\n## 수정번호\n* Release v2.00_240425: 목록 조회 조건 및 결과에 사이트 정보 추가\n* Release v2.00_240530: 날짜조회 쿼리 변경\n* Release v2.00_250428: 날짜조회 쿼리 변경 - BO 선택 옵션 (3, 7, 30, 전체) 추가되어 전체인 경우 날짜 조건 제외\n","operationId":"getEventSurveyList","parameters":[{"name":"evtNo","in":"query","description":"이벤트번호","schema":{"type":"string"}},{"name":"trgmnSeq","in":"query","description":"응모번호","schema":{"type":"string"}},{"name":"mbrNo","in":"query","description":"회원번호","schema":{"type":"string"}},{"name":"aempId","in":"query","description":"등록자","schema":{"type":"string"}},{"name":"startDate","in":"query","description":"시작날짜","schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"끝날짜","schema":{"type":"LocalDate"}},{"name":"periodGb","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"}},{"name":"dateSelect","in":"query","description":"날짜선택옵션","schema":{"type":"string"}}],"responses":{"200":{"description":"설문 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseEvtSurveyResponse"}}}},"900":{"description":"설문 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```