> 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/store-front-api/event-api/undefined-1.md).
# 이벤트 참여내역
## 이벤트 배송지 저장
> \## 기능 설명\
> \* 이벤트 DB 배송지 변경 기본 API입니다.\
> \---\
> \## 상세 설명\
> \* 회원번호와 응모한 이벤트 번호를 받아 응모자 테이블의 배송지 정보 변경을합니다.\
> \* 해당 회원의 배송지 수정(EVENT DB)
```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":["이벤트 참여내역"],"summary":"이벤트 배송지 저장","description":"## 기능 설명\n* 이벤트 DB 배송지 변경 기본 API입니다.\n---\n## 상세 설명\n* 회원번호와 응모한 이벤트 번호를 받아 응모자 테이블의 배송지 정보 변경을합니다.\n* 해당 회원의 배송지 수정(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":"이벤트 응모자 정보","properties":{"trgmnSeq":{"type":"string","description":"대상자순번"},"evtTrgmnGbCd":{"type":"string","description":"이벤트대상자구분코드(EV012)"},"mbrNo":{"type":"string","description":"회원번호"},"sbscAplyDtm":{"type":"string","format":"date-time","description":"응모신청일시"},"wtpsSltDtm":{"type":"string","format":"date-time","description":"대기자선정일시"},"winDtm":{"type":"string","description":"당첨일시"},"winRnk":{"type":"integer","format":"int32","description":"당첨순위"},"smsSndCnt":{"type":"integer","format":"int32","description":"SMS발송수"},"winCnclDtm":{"type":"string","format":"date-time","description":"당첨취소일시"},"winCnclCausCont":{"type":"string","description":"당첨취소사유내용"},"evtNo":{"type":"string","description":"이벤트번호"},"waitRnk":{"type":"integer","format":"int32","description":"대기순위"},"intx":{"type":"integer","format":"int32","description":"소득세"},"citx":{"type":"integer","format":"int32","description":"주민세"},"myCertiDtm":{"type":"string","format":"date-time","description":"본인인증일시"},"ordSumAmt":{"type":"integer","format":"int32","description":"주문합계금액"},"cfmOrdAmt":{"type":"integer","format":"int32","description":"확정주문금액"},"evtSbscPathCd":{"type":"string","description":"이벤트응모경로코드"},"tubaBankCd":{"type":"string","description":"제세공과금은행코드"},"tubaDepositorNm":{"type":"string","description":"제세공과금예금주명"},"tubaVirActnNo":{"type":"string","description":"제세공과금가상계좌번호"},"tubaDptAmt":{"type":"integer","format":"int32","description":"제세공과금입금액"},"tubaDptDtm":{"type":"string","format":"date-time","description":"제세공과금입금일시"},"deliHdcCd":{"type":"string","description":"배송택배사코드(LO005)"},"deliInvNo":{"type":"string","description":"배송운송장번호"},"mailSndCnt":{"type":"integer","format":"int32","description":"메일발송수"},"bbcNo":{"type":"string","description":"게시글번호"},"lotCondSeq":{"type":"string","description":"추첨조건순번"},"etcGftDlvpNo":{"type":"string","description":"기타사은품배송지번호"},"etcGftStatCd":{"type":"string","description":"기타사은품상태코드"},"paysYn":{"type":"string","description":"지급여부"},"paysDtm":{"type":"string","format":"date-time","description":"지급일시"},"trnsYn":{"type":"string","description":"배송전송여부"},"rcvmnNm":{"type":"string","description":"수취인명"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"deliMsg":{"type":"string","description":"배송메시지"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드"},"evtFvrSeq":{"type":"string","description":"이벤트 혜택순번"}}}}}}
```
## 이벤트 구매 사은 응모 내역 조회
> \## 기능 설명\
> \* 이벤트 사은품 응모 내역 조회 기본 API입니다.\
> \---\
> \## 상세 설명\
> \* 로그인 필수입니다.\
> \* 구매 사은 이벤트 응모 내역만 노출합니다.\
> \* 진행상태, 기간(1주, 1개월, 3개월) 조건 조회 가능합니다.\
> \## 수정 번호\
> \* Release v2.00\_240425: 이벤트 목록 조회 조건에 사이트번호 추가
```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":["이벤트 참여내역"],"summary":"이벤트 구매 사은 응모 내역 조회","description":"## 기능 설명\n* 이벤트 사은품 응모 내역 조회 기본 API입니다.\n---\n## 상세 설명\n* 로그인 필수입니다.\n* 구매 사은 이벤트 응모 내역만 노출합니다.\n* 진행상태, 기간(1주, 1개월, 3개월) 조건 조회 가능합니다.\n## 수정 번호\n* Release v2.00_240425: 이벤트 목록 조회 조건에 사이트번호 추가\n","operationId":"getPurFreeEventList","parameters":[{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"string","description":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string","description":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string","description":"string"}},{"name":"periodGb","in":"query","description":"기간 검색 구분","required":true,"schema":{"type":"string","description":"string"}},{"name":"filteringGb","in":"query","description":"진행상태(진행중/종료)","schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"사은품 응모 내역 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EventParticipationResponse"}}}},"900":{"description":"사은품 응모 내역 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EventParticipationResponse":{"type":"object","description":"이벤트 참여목록 Response","properties":{"allPageCnt":{"type":"integer","format":"int32","description":"전체페이지갯수"},"curPageNo":{"type":"integer","format":"int32","description":"현재페이지번호"},"purEvtCnt":{"type":"integer","format":"int32","description":"자동응모갯수"},"evtTrgmnInfo":{"type":"array","description":"이벤트 상세","items":{"$ref":"#/components/schemas/EventParticipationDetailResponse"}}}},"EventParticipationDetailResponse":{"type":"object","description":"이벤트 참여목록 상세 Response","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"evtNm":{"type":"string","description":"이벤트명"},"evtStrDtm":{"type":"string","format":"date","description":"이벤트시작일시"},"evtEndDtm":{"type":"string","format":"date-time","description":"이벤트종료일시"},"evtPrgsStatCd":{"type":"string","description":"관리상태(EV005)"},"evtPrgsStatNm":{"type":"string","description":"관리상태명"},"orgEvtPrgsStatCd":{"type":"string","description":"실제관리상태코드(EV005)"},"evtUrlAddr":{"type":"string","description":"이벤트URL주소"},"evtBnrPathNm":{"type":"string","description":"이벤트배너경로명"},"evtBnrFileNm":{"type":"string","description":"이벤트배너파일명"},"evtBnrAltCont":{"type":"string","description":"이벤트배너이미지 대체텍스트"},"pcEvtBnrPathNm":{"type":"string","description":"PC용이벤트배너경로명"},"pcEvtBnrFileNm":{"type":"string","description":"PC용이벤트배너파일명"},"pcEvtBnrAltCont":{"type":"string","description":"PC용이벤트배너이미지 대체텍스트"},"evtTrgmnGbCd":{"type":"string","description":"이벤트대상자구분코드(EV012)"},"winDtm":{"type":"string","description":"당첨일시"},"winRnk":{"type":"integer","format":"int32","description":"당첨순위"},"evtFvrTypCd":{"type":"string","description":"이벤트혜택유형코드(EV011)"},"evtGoodsNm":{"type":"string","description":"이벤트상품명"},"payMilg":{"type":"integer","format":"int32","description":"지급마일리지"},"pmgdSndDt":{"type":"string","description":"경품발송일자"},"payDt":{"type":"string","description":"포인트 지급일자"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"주소"},"dtlAddr":{"type":"string","description":"상세주소"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"rcvmnNm":{"type":"string","description":"수취인명"},"etcGftStatCd":{"type":"string","description":"기타사은품상태코드(LO013)"},"etcGftStatNm":{"type":"string","description":"기타사은품상태명"},"purAmtEvtPromoYn":{"type":"string","description":"구매금액이벤트프로모션여부"},"buyAmt":{"type":"integer","format":"int32","description":"사은품지급구매금액"},"purAmt":{"type":"integer","format":"int64","description":"구매금액"},"evtLgrpCd":{"type":"string","description":"이벤트유형 대분류코드(EV001)"},"evtMgrpCd":{"type":"string","description":"이벤트유형 중분류코드(EV002)"},"goodsImgPath":{"type":"string","description":"상품이미지경로"},"evetTermDesc":{"type":"string","description":"행사기간설명"},"evetCondDesc":{"type":"string","description":"행사조건설명"},"etcDesc1":{"type":"string","description":"기타설명1"},"etcDesc2":{"type":"string","description":"기타설명2"},"etcDesc3":{"type":"string","description":"기타설명3"},"etcDesc4":{"type":"string","description":"기타설명4"},"etcDesc5":{"type":"string","description":"기타설명5"},"paysTermDesc":{"type":"string","description":"지급기간설명"},"paysYn":{"type":"string","description":"지급여부"},"paysDtm":{"type":"string","description":"지급일시"},"winCnclDtm":{"type":"string","description":"당첨취소시간"},"trgmnSeq":{"type":"string","description":"대상자순번"},"pmgdSndDtCal":{"type":"integer","format":"int32","description":"사은품발송일계산"},"etcGftDlvpNo":{"type":"string","description":"기타사은품배송지번호"},"trnsYn":{"type":"string","description":"배송전송여부"},"hdcCd":{"type":"string","description":"택배사코드(LO005)"},"invNo":{"type":"string","description":"운송장번호"},"sbscAplyStrDtm":{"type":"string","format":"date-time","description":"응모/신청기간시작일"},"sbscAplyEndDtm":{"type":"string","format":"date-time","description":"응모/신청기간종료일"},"buyStrDtm":{"type":"string","format":"date-time","description":"구매시작일시"},"buyEndDtm":{"type":"string","format":"date-time","description":"구매종료일시"},"sbscPsbMinOrdAmt":{"type":"integer","format":"int32","description":"최소구매금액"},"orderList":{"type":"array","description":"주문내역","items":{"$ref":"#/components/schemas/EventMemberOrderGoodsDtlResponse"}}}},"EventMemberOrderGoodsDtlResponse":{"type":"object","description":"주문정보 상세 Response","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordDtm":{"type":"string","format":"date-time","description":"주문일자"},"ordAmt":{"type":"integer","format":"int64","description":"주문금액"}}},"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"}}}}}}
```
## 이벤트 참여내역 조회
> \## 기능 설명\
> \* 이벤트 참여내역 조회 기본 API입니다.\
> \---\
> \## 상세 설명\
> \* 로그인 필수입니다.\
> \* 구매 사은 이벤트를 제외한 이벤트 참여내역 조회\
> \* 진행상태, 기간(1주, 1개월, 3개월) 조건 조회 가능\
> \---\
> \## 수정 내역\
> \* Release v2.00\_240401 : 구매 사은 이벤트 내역 포함\
> \* Release v2.00\_240425: 목록 조회 조건에 사이트번호 추가
```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":["이벤트 참여내역"],"summary":"이벤트 참여내역 조회","description":"## 기능 설명\n* 이벤트 참여내역 조회 기본 API입니다.\n---\n## 상세 설명\n* 로그인 필수입니다.\n* 구매 사은 이벤트를 제외한 이벤트 참여내역 조회\n* 진행상태, 기간(1주, 1개월, 3개월) 조건 조회 가능\n---\n## 수정 내역\n* Release v2.00_240401 : 구매 사은 이벤트 내역 포함\n* Release v2.00_240425: 목록 조회 조건에 사이트번호 추가\n","operationId":"getMyEventEntryList","parameters":[{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"string","description":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string","description":"string"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string","description":"string"}},{"name":"periodGb","in":"query","description":"기간 검색 구분","required":true,"schema":{"type":"string","description":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"이벤트 참여내역 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EventParticipationResponse"}}}},"900":{"description":"이벤트 참여내역 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EventParticipationResponse":{"type":"object","description":"이벤트 참여목록 Response","properties":{"allPageCnt":{"type":"integer","format":"int32","description":"전체페이지갯수"},"curPageNo":{"type":"integer","format":"int32","description":"현재페이지번호"},"purEvtCnt":{"type":"integer","format":"int32","description":"자동응모갯수"},"evtTrgmnInfo":{"type":"array","description":"이벤트 상세","items":{"$ref":"#/components/schemas/EventParticipationDetailResponse"}}}},"EventParticipationDetailResponse":{"type":"object","description":"이벤트 참여목록 상세 Response","properties":{"evtNo":{"type":"string","description":"이벤트번호"},"evtNm":{"type":"string","description":"이벤트명"},"evtStrDtm":{"type":"string","format":"date","description":"이벤트시작일시"},"evtEndDtm":{"type":"string","format":"date-time","description":"이벤트종료일시"},"evtPrgsStatCd":{"type":"string","description":"관리상태(EV005)"},"evtPrgsStatNm":{"type":"string","description":"관리상태명"},"orgEvtPrgsStatCd":{"type":"string","description":"실제관리상태코드(EV005)"},"evtUrlAddr":{"type":"string","description":"이벤트URL주소"},"evtBnrPathNm":{"type":"string","description":"이벤트배너경로명"},"evtBnrFileNm":{"type":"string","description":"이벤트배너파일명"},"evtBnrAltCont":{"type":"string","description":"이벤트배너이미지 대체텍스트"},"pcEvtBnrPathNm":{"type":"string","description":"PC용이벤트배너경로명"},"pcEvtBnrFileNm":{"type":"string","description":"PC용이벤트배너파일명"},"pcEvtBnrAltCont":{"type":"string","description":"PC용이벤트배너이미지 대체텍스트"},"evtTrgmnGbCd":{"type":"string","description":"이벤트대상자구분코드(EV012)"},"winDtm":{"type":"string","description":"당첨일시"},"winRnk":{"type":"integer","format":"int32","description":"당첨순위"},"evtFvrTypCd":{"type":"string","description":"이벤트혜택유형코드(EV011)"},"evtGoodsNm":{"type":"string","description":"이벤트상품명"},"payMilg":{"type":"integer","format":"int32","description":"지급마일리지"},"pmgdSndDt":{"type":"string","description":"경품발송일자"},"payDt":{"type":"string","description":"포인트 지급일자"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"주소"},"dtlAddr":{"type":"string","description":"상세주소"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"rcvmnNm":{"type":"string","description":"수취인명"},"etcGftStatCd":{"type":"string","description":"기타사은품상태코드(LO013)"},"etcGftStatNm":{"type":"string","description":"기타사은품상태명"},"purAmtEvtPromoYn":{"type":"string","description":"구매금액이벤트프로모션여부"},"buyAmt":{"type":"integer","format":"int32","description":"사은품지급구매금액"},"purAmt":{"type":"integer","format":"int64","description":"구매금액"},"evtLgrpCd":{"type":"string","description":"이벤트유형 대분류코드(EV001)"},"evtMgrpCd":{"type":"string","description":"이벤트유형 중분류코드(EV002)"},"goodsImgPath":{"type":"string","description":"상품이미지경로"},"evetTermDesc":{"type":"string","description":"행사기간설명"},"evetCondDesc":{"type":"string","description":"행사조건설명"},"etcDesc1":{"type":"string","description":"기타설명1"},"etcDesc2":{"type":"string","description":"기타설명2"},"etcDesc3":{"type":"string","description":"기타설명3"},"etcDesc4":{"type":"string","description":"기타설명4"},"etcDesc5":{"type":"string","description":"기타설명5"},"paysTermDesc":{"type":"string","description":"지급기간설명"},"paysYn":{"type":"string","description":"지급여부"},"paysDtm":{"type":"string","description":"지급일시"},"winCnclDtm":{"type":"string","description":"당첨취소시간"},"trgmnSeq":{"type":"string","description":"대상자순번"},"pmgdSndDtCal":{"type":"integer","format":"int32","description":"사은품발송일계산"},"etcGftDlvpNo":{"type":"string","description":"기타사은품배송지번호"},"trnsYn":{"type":"string","description":"배송전송여부"},"hdcCd":{"type":"string","description":"택배사코드(LO005)"},"invNo":{"type":"string","description":"운송장번호"},"sbscAplyStrDtm":{"type":"string","format":"date-time","description":"응모/신청기간시작일"},"sbscAplyEndDtm":{"type":"string","format":"date-time","description":"응모/신청기간종료일"},"buyStrDtm":{"type":"string","format":"date-time","description":"구매시작일시"},"buyEndDtm":{"type":"string","format":"date-time","description":"구매종료일시"},"sbscPsbMinOrdAmt":{"type":"integer","format":"int32","description":"최소구매금액"},"orderList":{"type":"array","description":"주문내역","items":{"$ref":"#/components/schemas/EventMemberOrderGoodsDtlResponse"}}}},"EventMemberOrderGoodsDtlResponse":{"type":"object","description":"주문정보 상세 Response","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordDtm":{"type":"string","format":"date-time","description":"주문일자"},"ordAmt":{"type":"integer","format":"int64","description":"주문금액"}}},"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"}}}}}}
```