> 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"}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://tech.x2bee.com/api/store-front-api/event-api/undefined-1.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.