> 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/api-guides-en/store-front/event/event-inquiry.md).

# Event Inquiry

Provides shopping mall customers with a list of currently ongoing events. The event list includes all types of events except event surveys, and the detail view lets you check whether you have entered, the template, the latest events, and the detailed items of the event.

***

## Key Features

* **Event list inquiry:**
  * Sorts ongoing events by newest or by closing date, displaying up to 10 per page.
* **Event detail inquiry:**
  * Retrieves entry status, template, latest events, and the detailed items of the event (attendance check, comments, orders, survey information).
* **Template and reward inquiry:**
  * Retrieves the template and reward information for the event.
* **Latest event inquiry:**
  * Retrieves the latest 4 events.
* **Event survey list inquiry:**
  * Retrieves the list of survey (customer review) events; there is no top pinning.
* **Event survey detail inquiry:**
  * For logged-in users, retrieves entry status and survey responses.

## Process Definition

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FcKamTxHvxTKdlm9fh2UG%2Fevent.png?alt=media&#x26;token=1e9a9b2c-9b0c-4c62-88a9-b8d587c4f788" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Inquiry of ongoing events

* Ongoing event: the progress status is "In Progress" and today's date falls within the display period
* Survey events are not shown in the list.
  {% endstep %}

{% step %}

### Event detail inquiry

* If you access the detail of an event that is not currently in progress, an alert "This is not the event period" is displayed
* For attendance check / comments / purchase gift / purchaser drawing, additional data is retrieved when logged in.
  * Example: member attendance information, member order information, member comment information
* Retrieves the latest 4 events (MO basis).
  {% endstep %}

{% step %}

### Inquiry of ongoing survey events

* There is no top-pinning option.
  {% endstep %}

{% step %}

### Event survey detail inquiry

* When logged in, if the member has a history of entering the event, the corresponding Q\&A is retrieved and displayed.
  {% endstep %}
  {% endstepper %}

## API Function List

<table><thead><tr><th width="113.4444580078125">API</th><th width="299">Description</th><th width="93.5555419921875">Server</th><th width="95.7777099609375">Method</th><th>Notes</th></tr></thead><tbody><tr><td>Event list inquiry</td><td>Retrieves top-pinned events and currently ongoing events (excluding surveys).</td><td>Event</td><td>GET</td><td><a href="https://api.x2bee.com/content?msa=event&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A1%B0%ED%9A%8C&#x26;path=getEventList">🔗View API ></a></td></tr><tr><td>Event detail inquiry</td><td>Retrieves the detailed information of the event and the latest 4 events.</td><td>Event</td><td>GET</td><td><p><a href="https://api.x2bee.com/content?msa=event&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A1%B0%ED%9A%8C&#x26;path=getEventDetail">🔗View API ></a></p><p>Order information inquiry: v1/event/evtOrdList</p><p>Product summary information inquiry: v1/detail/summary</p></td></tr><tr><td>Event customer review (survey) list inquiry</td><td>Retrieves currently ongoing customer review (survey) events.</td><td>Event</td><td>GET</td><td><a href="https://api.x2bee.com/content?msa=event&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A1%B0%ED%9A%8C&#x26;path=getCustReviewList">🔗View API ></a></td></tr><tr><td>Event customer review (survey) detail inquiry</td><td>Retrieves the survey Q&#x26;A information for the event.</td><td>Event</td><td>GET</td><td><a href="https://api.x2bee.com/content?msa=event&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%A1%B0%ED%9A%8C&#x26;path=getCustReviewDetail">🔗View API ></a></td></tr></tbody></table>

## Term Definitions

<table><thead><tr><th width="174">Term</th><th>Description</th><th data-hidden>Notes</th></tr></thead><tbody><tr><td>Display period</td><td>The period during which the event is displayed in the event list. Events whose display period has ended cannot be accessed in detail.</td><td></td></tr><tr><td>Entry period (event period)</td><td>The period during which entry is possible when the Enter button is clicked on the event detail screen</td><td></td></tr><tr><td>Purchase period</td><td>The period during which the designated product can be purchased</td><td></td></tr><tr><td>Drawing event</td><td>An event in which winners are determined through a drawing</td><td></td></tr><tr><td>Non-drawing event</td><td>An event with immediate payout or no reward, rather than a drawing</td><td></td></tr><tr><td>Reward</td><td>Benefit information (gift, prize, mileage, coupon) provided upon winning an event</td><td></td></tr></tbody></table>

## Other Notes

### Event list inquiry

#### General events

* Access path: Full Menu > Event
* Inquiry condition: the display period must include the current day and the event progress status must be in progress (survey events excluded)

#### Survey (customer review) events

* Access path: Full Menu > Customer Reviews
* Inquiry condition: events whose event type sub-category is "survey," whose display period includes the current day, and whose progress status is in progress

### Event detail inquiry

When accessing event details while logged in, additional member information is retrieved depending on the event type.

* Information retrieved when logged in
  * Attendance check: inquiry of the user's attendance check history
  * Comments: entry status, comments I have written
  * Survey: entry status, survey answer content
  * Purchase gift: entry status, inquiry of the member's order information list
  * Roulette/simple click: entry status
  * Purchaser drawing: entry status, inquiry of the member's order information list