> 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-guide/back-office/marketing-bo/undefined-6.md).

# 이벤트 설문 조회

쇼핑몰의 설문 이벤트 조회 및 결과 확인 서비스는 다양한 조회 조건을 활용하여 진행된 설문 이벤트를 조회하고, 응모자의 선택/작성한 결과를 상세히 확인하는 기능을 제공합니다.

***

## 주요 기능

* **설문 이벤트 조회**
  * 조회기간, 회원ID/명, 응모번호, 이벤트 번호/명을 설정하여 설문 이벤트 목록을 조회합니다.
  * 선택한 이벤트의 미리보기를 통해 이벤트의 주요 내용을 확인합니다.
* **설문 결과 확인**
  * 선택한 이벤트의 응모자가 선택/작성한 설문 결과를 자세히 확인합니다.
  * 응답 내용은 각 문항에 대한 표시로 가시성을 높입니다.
* **설문 결과 엑셀 다운로드**
  * 조회된 설문 결과 목록을 그리드 형식으로 확인하고, 엑셀 다운로드를 통해 데이터를 내려받을 수 있습니다.

## 프로세스 정의

<figure><img src="/files/sK0hPmeGw59b193W7Kcr" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 목록 조회

조건을 설정하여 진행한 설문 이벤트 목록과 설문 결과를 조회합니다.
{% endstep %}

{% step %}

### 이벤트 상세 조회

해당 행의 이벤트 번호를 클릭 시, 해당 이벤트 상세를 조회합니다.\
참고 : 이벤트정보관리 상세조회
{% endstep %}

{% step %}

### 설문 상세 조회

이벤트의 설문 문항과 응모자가 선택한 문항을 조회합니다.
{% endstep %}

{% step %}

### 이벤트 미리보기

해당 행의 이벤트 명을 클릭 시, 미리보기 파라미터 (previewDate)값이 “Y”인 상태로, 해당 MO 이벤트 상세 미리보기 화면이 호출됩니다.
{% endstep %}

{% step %}

### 설문 결과 다운로드

화면 내 조회된 그리드에 있는 모든 목록을 엑셀 다운로드 합니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="112.3333740234375">API</th><th width="314.6666259765625">설명</th><th width="92.4444580078125">Server</th><th width="92.4444580078125">메소드</th><th>비고</th></tr></thead><tbody><tr><td>이벤트 설문상세 조회</td><td>설문 응모한 회원의 이벤트 설문상세를 조회합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%84%A4%EB%AC%B8%20%EC%A1%B0%ED%9A%8C&#x26;path=getEventSurveyDetail">🔗API 확인하기 ></a></td></tr><tr><td>이벤트 설문 목록 조회</td><td>이벤트 설문 목록을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%84%A4%EB%AC%B8%20%EC%A1%B0%ED%9A%8C&#x26;path=getEventSurveyList">🔗API 확인하기 ></a></td></tr><tr><td>이벤트 설문조회 건수 조회</td><td>이벤트 설문조회 건수를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%84%A4%EB%AC%B8%20%EC%A1%B0%ED%9A%8C&#x26;path=getEventSurveyListCount">🔗API 확인하기 ></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="126.2222900390625">명칭</th><th>설명</th><th data-hidden></th></tr></thead><tbody><tr><td>전시기간</td><td>이벤트가 이벤트 목록에서 전시되는 기간. 전시기간이 끝난 이벤트는 상세 진입이 <br>안됩니다.</td><td></td></tr><tr><td>응모기간<br>(행사기간)</td><td>이벤트 응모가 되는 기간</td><td></td></tr><tr><td>추첨이벤트</td><td>추첨을 통해서 당첨자가 정해지는 이벤트</td><td></td></tr><tr><td>비추첨이벤트</td><td>추첨이 아닌 즉시지급, 또는 리워드 없는 이벤트</td><td></td></tr></tbody></table>