> 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-participation-history.md).

# Event Participation History

The event participation history inquiry feature lets a logged-in member check the events they have entered under 'My Page - Participation History'. Participation history is divided into 'Event Participation' and 'Purchase Gift Entries', and 'Purchase Gift Entries' shows only entry records for the corresponding events.

***

## Key Features

* **Event participation history inquiry**
  * Retrieves the list of events the logged-in member has participated in.
  * Shows event participation history excluding purchase gift events.
  * Retrieves event participation history within the given period using a period search classification code (1 week, 1 month, 3 months).
  * Retrieves event participation history matching the given condition using a filtering classification code (won, in progress, ended).
* **Purchase gift event participation history inquiry**
  * Retrieves the list of purchase gift events the logged-in member has participated in.
  * Retrieves purchase gift event participation history within the given period using a period search classification code (1 week, 1 month, 3 months).
  * Retrieves purchase gift event participation history matching the given condition using a filtering classification code (won, in progress, ended).
* **Event delivery address change**
  * When the reward is a prize/gift, the default delivery address is set to the member's default delivery address.
  * The address can be changed via the event delivery address save API; when modified, the reward delivery address (prize/gift) is saved as the changed address.

## Process Definition

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2Fal6kyhedkrQMET8RYqG1%2F%E1%84%8B%E1%85%B5%E1%84%87%E1%85%A6%E1%86%AB%E1%84%90%E1%85%B3%E1%84%8E%E1%85%A1%E1%86%B7%E1%84%8B%E1%85%A7%E1%84%82%E1%85%A2%E1%84%8B%E1%85%A7%E1%86%A8.png?alt=media&#x26;token=72c8f611-3fce-41d9-9423-b7108d7cd0e2" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Navigate to My Page

When a member accesses My Page, if logged in, the member's information is displayed; if not logged in, the member is redirected to the login page.
{% endstep %}

{% step %}

### Event participation history

When accessing participation history, the default is to retrieve event participation history within the past 1 week.\
The inquiry conditions can be changed using the period search code value and the filtering value (in progress, ended, won).
{% endstep %}

{% step %}

### Save event delivery address

If the reward has not yet been paid out and the reward is a gift/prize, the recipient address can be changed via the "Change Recipient" option and saved as the new event delivery address.
{% endstep %}
{% endstepper %}

## API Function List

<table><thead><tr><th width="147.888916015625">API</th><th width="231.111083984375">Description</th><th width="93.5555419921875">Server</th><th width="91.4444580078125">Method</th><th>Notes</th></tr></thead><tbody><tr><td>Event participation history inquiry</td><td>Retrieves the participation history of the logged-in member.</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%B0%B8%EC%97%AC%EB%82%B4%EC%97%AD&#x26;path=getMyEventEntryList">🔗View API ></a></td></tr><tr><td>Event purchase<br>gift entry history inquiry</td><td>Retrieves the purchase gift entry history of the logged-in member.</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%B0%B8%EC%97%AC%EB%82%B4%EC%97%AD&#x26;path=getPurFreeEventList">🔗View API ></a></p><p>Order information inquiry: /api/order/v1/event/evtOrdList</p><p>Product summary information inquiry: /api/goods/v1/detail/summary</p></td></tr><tr><td>Event delivery address<br>save</td><td>Changes and saves the event delivery address of the entered member.</td><td>Event</td><td>POST</td><td><a href="https://api.x2bee.com/content?msa=event&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%B0%B8%EC%97%AC%EB%82%B4%EC%97%AD&#x26;path=evtDlvChange">🔗View API ></a></td></tr></tbody></table>

## Term Definitions

<table><thead><tr><th width="169.5555419921875">Term</th><th>Description</th><th data-hidden>Notes</th></tr></thead><tbody><tr><td>Display period​</td><td>Refers to 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>Refers to the period during which entry is possible after clicking the Enter button on the event detail screen.​</td><td></td></tr><tr><td>Purchase period​</td><td>Refers to the period during which products applicable to the event can be purchased.​</td><td></td></tr><tr><td>Drawing event​</td><td>Refers to an event in which companies select winners through a drawing to provide consumers with various items such as gifts, mileage, and coupons​.</td><td></td></tr><tr><td>Non-drawing event​</td><td>Refers to an event in which benefits (coupons, mileage) are granted when participants meet certain conditions or perform a specific activity.​ (Immediate payout rather than a drawing — attendance, purchase gift, etc.)​</td><td></td></tr><tr><td>Event reward​</td><td>Represents the compensation or benefit given to people who participate in the event. ​ Benefit information provided upon winning an event includes gifts, prizes, mileage, coupons, and so on.​</td><td></td></tr></tbody></table>

## Other Notes

* **Event participation history / purchase gift entry history inquiry**

  Event participation history and purchase gift entry history inquiries use a period search classification code (periodGb) and a filtering classification value (filteringGb) as inquiry conditions.

  * Period search classification code (periodGb)
    * 0: 1 week
    * 1: 1 month
    * 2: 3 months
    * 3: date range search
  * Filtering classification code (filteringGb)
    * Default: all
    * 1: won events
    * 2: events in progress
    * 3: ended events
* **Save event delivery address**

  Saving the event delivery address is only possible when the reward is a gift/prize.

  In the following cases, the 'Change Recipient' button is not displayed and the address cannot be saved:

  * Payout status is Y
  * A payout date/time exists
  * A miscellaneous gift delivery address number exists
  * Event progress status (EV005): prize shipment complete (07)
  * Miscellaneous gift status code (LO013): delivery complete (40)

  The event delivery address updates the address information in the entrant table of CC\_EVT\_TRGMN\_INFO.