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

1

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.

2

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

3

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.

API Function List

API	Description	Server	Method	Notes
Event participation history inquiry	Retrieves the participation history of the logged-in member.	Event	GET	🔗View API >
Event purchase gift entry history inquiry	Retrieves the purchase gift entry history of the logged-in member.	Event	GET	🔗View API > Order information inquiry: /api/order/v1/event/evtOrdList Product summary information inquiry: /api/goods/v1/detail/summary
Event delivery address save	Changes and saves the event delivery address of the entered member.	Event	POST	🔗View API >

Term Definitions

Term	Description
Display period​	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.​
Entry period (event period)​	Refers to the period during which entry is possible after clicking the Enter button on the event detail screen.​
Purchase period​	Refers to the period during which products applicable to the event can be purchased.​
Drawing event​	Refers to an event in which companies select winners through a drawing to provide consumers with various items such as gifts, mileage, and coupons​.
Non-drawing event​	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.)​
Event reward​	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.​

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.