> 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/api-en/store-front-api-reference/event-api/event-participation-history.md).

# Event Participation History

## Save Event Delivery Address

> \## Function Description\
> \* This is the basic API for changing the delivery address in the event DB.\
> \---\
> \## Detailed Description\
> \* Changes the delivery address information in the entrant table using the member number and the event number entered.\
> \* Edits the member's delivery address (EVENT DB)<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/marketing/evtDlvChange":{"post":{"tags":["Event Participation History"],"summary":"Save Event Delivery Address","description":"## Function Description\n* This is the basic API for changing the delivery address in the event DB.\n---\n## Detailed Description\n* Changes the delivery address information in the entrant table using the member number and the event number entered.\n* Edits the member's delivery address (EVENT DB)\n","operationId":"evtDlvChange","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CcEvtTrgmnInfo"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"CcEvtTrgmnInfo":{"type":"object","description":"Event Entrant Information","properties":{"trgmnSeq":{"type":"string","description":"Target Sequence No."},"evtTrgmnGbCd":{"type":"string","description":"Event Target Classification Code (EV012)"},"mbrNo":{"type":"string","description":"Member No."},"sbscAplyDtm":{"type":"string","format":"date-time","description":"Application Date/Time"},"wtpsSltDtm":{"type":"string","format":"date-time","description":"Waitlist Selection Date/Time"},"winDtm":{"type":"string","description":"Winning Date/Time"},"winRnk":{"type":"integer","format":"int32","description":"Winning Rank"},"smsSndCnt":{"type":"integer","format":"int32","description":"SMS Sent Count"},"winCnclDtm":{"type":"string","format":"date-time","description":"Winning Cancellation Date/Time"},"winCnclCausCont":{"type":"string","description":"Winning Cancellation Reason Content"},"evtNo":{"type":"string","description":"Event No."},"waitRnk":{"type":"integer","format":"int32","description":"Waitlist Rank"},"intx":{"type":"integer","format":"int32","description":"Income Tax"},"citx":{"type":"integer","format":"int32","description":"Local Income Tax"},"myCertiDtm":{"type":"string","format":"date-time","description":"Identity Verification Date/Time"},"ordSumAmt":{"type":"integer","format":"int32","description":"Total Order Amount"},"cfmOrdAmt":{"type":"integer","format":"int32","description":"Confirmed Order Amount"},"evtSbscPathCd":{"type":"string","description":"Event Entry Path Code"},"tubaBankCd":{"type":"string","description":"Tax/Duty Bank Code"},"tubaDepositorNm":{"type":"string","description":"Tax Withholding Account Holder Name"},"tubaVirActnNo":{"type":"string","description":"Tax Withholding Virtual Account No."},"tubaDptAmt":{"type":"integer","format":"int32","description":"Tax Withholding Deposit Amount"},"tubaDptDtm":{"type":"string","format":"date-time","description":"Tax Withholding Deposit Date/Time"},"deliHdcCd":{"type":"string","description":"Delivery Courier Company Code (LO005)"},"deliInvNo":{"type":"string","description":"Delivery Tracking No."},"mailSndCnt":{"type":"integer","format":"int32","description":"Email Send Count"},"bbcNo":{"type":"string","description":"Post Number"},"lotCondSeq":{"type":"string","description":"Drawing Condition Sequence No."},"etcGftDlvpNo":{"type":"string","description":"Other Gift Delivery Address No."},"etcGftStatCd":{"type":"string","description":"Other Gift Status Code"},"paysYn":{"type":"string","description":"Payment Status"},"paysDtm":{"type":"string","format":"date-time","description":"Payment Date/Time"},"trnsYn":{"type":"string","description":"Delivery Transmission Status"},"rcvmnNm":{"type":"string","description":"Recipient Name"},"zipNo":{"type":"string","description":"Postal Code"},"zipAddr":{"type":"string","description":"Postal Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"cellSctNo":{"type":"string","description":"Mobile Phone Prefix Code"},"cellTxnoNo":{"type":"string","description":"Mobile Phone Exchange Code"},"cellEndNo":{"type":"string","description":"Mobile Phone Last Digits"},"deliMsg":{"type":"string","description":"Delivery Message"},"comnFrdrEtcMethod":{"type":"string","description":"Other Common Entrance Access Method"},"comnFrdrPwd":{"type":"string","description":"Common Entrance Password"},"comnFrdrCogoMethodCd":{"type":"string","description":"Common Entrance Access Method Code"},"evtFvrSeq":{"type":"string","description":"Event Benefit Sequence No."}}}}}}
```

## Retrieve Event Purchase Gift Entry History

> \## Function Description\
> \* This is the basic API for retrieving gift entry history.\
> \---\
> \## Detailed Description\
> \* Login is required.\
> \* Displays only purchase gift event entry history.\
> \* Can be searched by progress status and period (1 week, 1 month, 3 months) conditions.\
> \## Revision History\
> \* Release v2.00\_240425: Added site number to the event list search conditions<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/marketing/getPurFreeEventList":{"get":{"tags":["Event Participation History"],"summary":"Retrieve Event Purchase Gift Entry History","description":"## Function Description\n* This is the basic API for retrieving gift entry history.\n---\n## Detailed Description\n* Login is required.\n* Displays only purchase gift event entry history.\n* Can be searched by progress status and period (1 week, 1 month, 3 months) conditions.\n## Revision History\n* Release v2.00_240425: Added site number to the event list search conditions\n","operationId":"getPurFreeEventList","parameters":[{"name":"siteNo","in":"query","description":"Site No.","schema":{"type":"string","description":"string"}},{"name":"pageIdx","in":"query","description":"Current Page","required":true,"schema":{"type":"string","description":"string"}},{"name":"rowsPerPage","in":"query","description":"Rows per Page","required":true,"schema":{"type":"string","description":"string"}},{"name":"periodGb","in":"query","description":"Period Search Type","required":true,"schema":{"type":"string","description":"string"}},{"name":"filteringGb","in":"query","description":"Progress Status (In Progress/Ended)","schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Gift entry history retrieved successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EventParticipationResponse"}}}},"900":{"description":"Failed to retrieve gift entry history","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EventParticipationResponse":{"type":"object","description":"Event Participation List Response","properties":{"allPageCnt":{"type":"integer","format":"int32","description":"Total Page Count"},"curPageNo":{"type":"integer","format":"int32","description":"Current Page No."},"purEvtCnt":{"type":"integer","format":"int32","description":"Automatic Entry Count"},"evtTrgmnInfo":{"type":"array","description":"Event Detail","items":{"$ref":"#/components/schemas/EventParticipationDetailResponse"}}}},"EventParticipationDetailResponse":{"type":"object","description":"Event Participation List Detail Response","properties":{"evtNo":{"type":"string","description":"Event No."},"evtNm":{"type":"string","description":"Event Name"},"evtStrDtm":{"type":"string","format":"date","description":"Event Start Date/Time"},"evtEndDtm":{"type":"string","format":"date-time","description":"Event End Date/Time"},"evtPrgsStatCd":{"type":"string","description":"Management Status (EV005)"},"evtPrgsStatNm":{"type":"string","description":"Management Status Name"},"orgEvtPrgsStatCd":{"type":"string","description":"Actual Management Status Code (EV005)"},"evtUrlAddr":{"type":"string","description":"Event URL"},"evtBnrPathNm":{"type":"string","description":"Event Banner Path"},"evtBnrFileNm":{"type":"string","description":"Event Banner File Name"},"evtBnrAltCont":{"type":"string","description":"Event Banner Image Alt Text"},"pcEvtBnrPathNm":{"type":"string","description":"PC Event Banner Path Name"},"pcEvtBnrFileNm":{"type":"string","description":"PC Event Banner File Name"},"pcEvtBnrAltCont":{"type":"string","description":"PC Event Banner Image Alt Text"},"evtTrgmnGbCd":{"type":"string","description":"Event Target Classification Code (EV012)"},"winDtm":{"type":"string","description":"Winning Date/Time"},"winRnk":{"type":"integer","format":"int32","description":"Winning Rank"},"evtFvrTypCd":{"type":"string","description":"Event Benefit Type Code (EV011)"},"evtGoodsNm":{"type":"string","description":"Event Product Name"},"payMilg":{"type":"integer","format":"int32","description":"Mileage Payout"},"pmgdSndDt":{"type":"string","description":"Prize Shipment Date"},"payDt":{"type":"string","description":"Point Payment Date"},"zipNo":{"type":"string","description":"Postal Code"},"zipAddr":{"type":"string","description":"Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"cellSctNo":{"type":"string","description":"Mobile Phone Prefix Code"},"cellTxnoNo":{"type":"string","description":"Mobile Phone Exchange Code"},"cellEndNo":{"type":"string","description":"Mobile Phone Last Digits"},"rcvmnNm":{"type":"string","description":"Recipient Name"},"etcGftStatCd":{"type":"string","description":"Other Gift Status Code (LO013)"},"etcGftStatNm":{"type":"string","description":"Other Gift Status Name"},"purAmtEvtPromoYn":{"type":"string","description":"Purchase Amount Event Promotion Status"},"buyAmt":{"type":"integer","format":"int32","description":"Gift Payment Purchase Amount"},"purAmt":{"type":"integer","format":"int64","description":"Purchase Amount"},"evtLgrpCd":{"type":"string","description":"Event Type Major Category Code (EV001)"},"evtMgrpCd":{"type":"string","description":"Event Type Subcategory Code (EV002)"},"goodsImgPath":{"type":"string","description":"Product Image Path"},"evetTermDesc":{"type":"string","description":"Event Period Description"},"evetCondDesc":{"type":"string","description":"Event Condition Description"},"etcDesc1":{"type":"string","description":"Other Description 1"},"etcDesc2":{"type":"string","description":"Other Description 2"},"etcDesc3":{"type":"string","description":"Other Description 3"},"etcDesc4":{"type":"string","description":"Other Description 4"},"etcDesc5":{"type":"string","description":"Other Description 5"},"paysTermDesc":{"type":"string","description":"Payout Period Description"},"paysYn":{"type":"string","description":"Payment Status"},"paysDtm":{"type":"string","description":"Payment Date/Time"},"winCnclDtm":{"type":"string","description":"Winning Cancellation Time"},"trgmnSeq":{"type":"string","description":"Target Sequence No."},"pmgdSndDtCal":{"type":"integer","format":"int32","description":"Gift Shipment Date Calculation"},"etcGftDlvpNo":{"type":"string","description":"Other Gift Delivery Address No."},"trnsYn":{"type":"string","description":"Delivery Transmission Status"},"hdcCd":{"type":"string","description":"Courier Company Code (LO005)"},"invNo":{"type":"string","description":"Tracking No."},"sbscAplyStrDtm":{"type":"string","format":"date-time","description":"Application Period Start Date"},"sbscAplyEndDtm":{"type":"string","format":"date-time","description":"Application Period End Date"},"buyStrDtm":{"type":"string","format":"date-time","description":"Purchase Start Date/Time"},"buyEndDtm":{"type":"string","format":"date-time","description":"Purchase End Date/Time"},"sbscPsbMinOrdAmt":{"type":"integer","format":"int32","description":"Minimum Purchase Amount"},"orderList":{"type":"array","description":"Order History","items":{"$ref":"#/components/schemas/EventMemberOrderGoodsDtlResponse"}}}},"EventMemberOrderGoodsDtlResponse":{"type":"object","description":"Order Information Detail Response","properties":{"ordNo":{"type":"string","description":"Order No."},"ordDtm":{"type":"string","format":"date-time","description":"Order Date"},"ordAmt":{"type":"integer","format":"int64","description":"Order Amount"}}},"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"}}}}}}
```

## Retrieve Event Participation History

> \## Function Description\
> \* This is the basic API for retrieving event participation history.\
> \---\
> \## Detailed Description\
> \* Login is required.\
> \* Retrieves event participation history excluding purchase gift events.\
> \* Can be searched by progress status and period (1 week, 1 month, 3 months) conditions.\
> \---\
> \## Revision History\
> \* Release v2.00\_240401 : Included purchase gift event history\
> \* Release v2.00\_240425: Added site number to the list search conditions<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Event API","version":"v1"},"servers":[{"url":"https://api-event.x2bee.com/api/event/","description":"prd"}],"paths":{"/v1/marketing/getMyEventEntryList":{"get":{"tags":["Event Participation History"],"summary":"Retrieve Event Participation History","description":"## Function Description\n* This is the basic API for retrieving event participation history.\n---\n## Detailed Description\n* Login is required.\n* Retrieves event participation history excluding purchase gift events.\n* Can be searched by progress status and period (1 week, 1 month, 3 months) conditions.\n---\n## Revision History\n* Release v2.00_240401 : Included purchase gift event history\n* Release v2.00_240425: Added site number to the list search conditions\n","operationId":"getMyEventEntryList","parameters":[{"name":"siteNo","in":"query","description":"Site No.","schema":{"type":"string","description":"string"}},{"name":"pageIdx","in":"query","description":"Current Page","required":true,"schema":{"type":"string","description":"string"}},{"name":"rowsPerPage","in":"query","description":"Rows per Page","required":true,"schema":{"type":"string","description":"string"}},{"name":"periodGb","in":"query","description":"Period Search Type","required":true,"schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Event participation history retrieved successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EventParticipationResponse"}}}},"900":{"description":"Failed to retrieve event participation history","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EventParticipationResponse":{"type":"object","description":"Event Participation List Response","properties":{"allPageCnt":{"type":"integer","format":"int32","description":"Total Page Count"},"curPageNo":{"type":"integer","format":"int32","description":"Current Page No."},"purEvtCnt":{"type":"integer","format":"int32","description":"Automatic Entry Count"},"evtTrgmnInfo":{"type":"array","description":"Event Detail","items":{"$ref":"#/components/schemas/EventParticipationDetailResponse"}}}},"EventParticipationDetailResponse":{"type":"object","description":"Event Participation List Detail Response","properties":{"evtNo":{"type":"string","description":"Event No."},"evtNm":{"type":"string","description":"Event Name"},"evtStrDtm":{"type":"string","format":"date","description":"Event Start Date/Time"},"evtEndDtm":{"type":"string","format":"date-time","description":"Event End Date/Time"},"evtPrgsStatCd":{"type":"string","description":"Management Status (EV005)"},"evtPrgsStatNm":{"type":"string","description":"Management Status Name"},"orgEvtPrgsStatCd":{"type":"string","description":"Actual Management Status Code (EV005)"},"evtUrlAddr":{"type":"string","description":"Event URL"},"evtBnrPathNm":{"type":"string","description":"Event Banner Path"},"evtBnrFileNm":{"type":"string","description":"Event Banner File Name"},"evtBnrAltCont":{"type":"string","description":"Event Banner Image Alt Text"},"pcEvtBnrPathNm":{"type":"string","description":"PC Event Banner Path Name"},"pcEvtBnrFileNm":{"type":"string","description":"PC Event Banner File Name"},"pcEvtBnrAltCont":{"type":"string","description":"PC Event Banner Image Alt Text"},"evtTrgmnGbCd":{"type":"string","description":"Event Target Classification Code (EV012)"},"winDtm":{"type":"string","description":"Winning Date/Time"},"winRnk":{"type":"integer","format":"int32","description":"Winning Rank"},"evtFvrTypCd":{"type":"string","description":"Event Benefit Type Code (EV011)"},"evtGoodsNm":{"type":"string","description":"Event Product Name"},"payMilg":{"type":"integer","format":"int32","description":"Mileage Payout"},"pmgdSndDt":{"type":"string","description":"Prize Shipment Date"},"payDt":{"type":"string","description":"Point Payment Date"},"zipNo":{"type":"string","description":"Postal Code"},"zipAddr":{"type":"string","description":"Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"cellSctNo":{"type":"string","description":"Mobile Phone Prefix Code"},"cellTxnoNo":{"type":"string","description":"Mobile Phone Exchange Code"},"cellEndNo":{"type":"string","description":"Mobile Phone Last Digits"},"rcvmnNm":{"type":"string","description":"Recipient Name"},"etcGftStatCd":{"type":"string","description":"Other Gift Status Code (LO013)"},"etcGftStatNm":{"type":"string","description":"Other Gift Status Name"},"purAmtEvtPromoYn":{"type":"string","description":"Purchase Amount Event Promotion Status"},"buyAmt":{"type":"integer","format":"int32","description":"Gift Payment Purchase Amount"},"purAmt":{"type":"integer","format":"int64","description":"Purchase Amount"},"evtLgrpCd":{"type":"string","description":"Event Type Major Category Code (EV001)"},"evtMgrpCd":{"type":"string","description":"Event Type Subcategory Code (EV002)"},"goodsImgPath":{"type":"string","description":"Product Image Path"},"evetTermDesc":{"type":"string","description":"Event Period Description"},"evetCondDesc":{"type":"string","description":"Event Condition Description"},"etcDesc1":{"type":"string","description":"Other Description 1"},"etcDesc2":{"type":"string","description":"Other Description 2"},"etcDesc3":{"type":"string","description":"Other Description 3"},"etcDesc4":{"type":"string","description":"Other Description 4"},"etcDesc5":{"type":"string","description":"Other Description 5"},"paysTermDesc":{"type":"string","description":"Payout Period Description"},"paysYn":{"type":"string","description":"Payment Status"},"paysDtm":{"type":"string","description":"Payment Date/Time"},"winCnclDtm":{"type":"string","description":"Winning Cancellation Time"},"trgmnSeq":{"type":"string","description":"Target Sequence No."},"pmgdSndDtCal":{"type":"integer","format":"int32","description":"Gift Shipment Date Calculation"},"etcGftDlvpNo":{"type":"string","description":"Other Gift Delivery Address No."},"trnsYn":{"type":"string","description":"Delivery Transmission Status"},"hdcCd":{"type":"string","description":"Courier Company Code (LO005)"},"invNo":{"type":"string","description":"Tracking No."},"sbscAplyStrDtm":{"type":"string","format":"date-time","description":"Application Period Start Date"},"sbscAplyEndDtm":{"type":"string","format":"date-time","description":"Application Period End Date"},"buyStrDtm":{"type":"string","format":"date-time","description":"Purchase Start Date/Time"},"buyEndDtm":{"type":"string","format":"date-time","description":"Purchase End Date/Time"},"sbscPsbMinOrdAmt":{"type":"integer","format":"int32","description":"Minimum Purchase Amount"},"orderList":{"type":"array","description":"Order History","items":{"$ref":"#/components/schemas/EventMemberOrderGoodsDtlResponse"}}}},"EventMemberOrderGoodsDtlResponse":{"type":"object","description":"Order Information Detail Response","properties":{"ordNo":{"type":"string","description":"Order No."},"ordDtm":{"type":"string","format":"date-time","description":"Order Date"},"ordAmt":{"type":"integer","format":"int64","description":"Order Amount"}}},"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"}}}}}}
```