Ctrlk
X2BEE Home
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Event Participation History

Save Event Delivery Address

post

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)

Header parameters
AuthorizationanyOptional

Access Token

Body

Event Entrant Information

trgmnSeqstringOptional

Target Sequence No.

evtTrgmnGbCdstringOptional

Event Target Classification Code (EV012)

mbrNostringOptional

Member No.

sbscAplyDtmstring · date-timeOptional

Application Date/Time

wtpsSltDtmstring · date-timeOptional

Waitlist Selection Date/Time

winDtmstringOptional

Winning Date/Time

winRnkinteger · int32Optional

Winning Rank

smsSndCntinteger · int32Optional

SMS Sent Count

winCnclDtmstring · date-timeOptional

Winning Cancellation Date/Time

winCnclCausContstringOptional

Winning Cancellation Reason Content

evtNostringOptional

Event No.

waitRnkinteger · int32Optional

Waitlist Rank

intxinteger · int32Optional

Income Tax

citxinteger · int32Optional

Local Income Tax

myCertiDtmstring · date-timeOptional

Identity Verification Date/Time

ordSumAmtinteger · int32Optional

Total Order Amount

cfmOrdAmtinteger · int32Optional

Confirmed Order Amount

evtSbscPathCdstringOptional

Event Entry Path Code

tubaBankCdstringOptional

Tax/Duty Bank Code

tubaDepositorNmstringOptional

Tax Withholding Account Holder Name

tubaVirActnNostringOptional

Tax Withholding Virtual Account No.

tubaDptAmtinteger · int32Optional

Tax Withholding Deposit Amount

tubaDptDtmstring · date-timeOptional

Tax Withholding Deposit Date/Time

deliHdcCdstringOptional

Delivery Courier Company Code (LO005)

deliInvNostringOptional

Delivery Tracking No.

mailSndCntinteger · int32Optional

Email Send Count

bbcNostringOptional

Post Number

lotCondSeqstringOptional

Drawing Condition Sequence No.

etcGftDlvpNostringOptional

Other Gift Delivery Address No.

etcGftStatCdstringOptional

Other Gift Status Code

paysYnstringOptional

Payment Status

paysDtmstring · date-timeOptional

Payment Date/Time

trnsYnstringOptional

Delivery Transmission Status

rcvmnNmstringOptional

Recipient Name

zipNostringOptional

Postal Code

zipAddrstringOptional

Postal Address

dtlAddrstringOptional

Detailed Address

cellSctNostringOptional

Mobile Phone Prefix Code

cellTxnoNostringOptional

Mobile Phone Exchange Code

cellEndNostringOptional

Mobile Phone Last Digits

deliMsgstringOptional

Delivery Message

comnFrdrEtcMethodstringOptional

Other Common Entrance Access Method

comnFrdrPwdstringOptional

Common Entrance Password

comnFrdrCogoMethodCdstringOptional

Common Entrance Access Method Code

evtFvrSeqstringOptional

Event Benefit Sequence No.

Responses
200

OK

*/*
stringOptional
post/v1/marketing/evtDlvChange
POST /api/event/v1/marketing/evtDlvChange HTTP/1.1
Host: api-event.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 941

{
  "trgmnSeq": "text",
  "evtTrgmnGbCd": "text",
  "mbrNo": "text",
  "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
  "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
  "winDtm": "text",
  "winRnk": 1,
  "smsSndCnt": 1,
  "winCnclDtm": "2026-01-01T00:00:00.000Z",
  "winCnclCausCont": "text",
  "evtNo": "text",
  "waitRnk": 1,
  "intx": 1,
  "citx": 1,
  "myCertiDtm": "2026-01-01T00:00:00.000Z",
  "ordSumAmt": 1,
  "cfmOrdAmt": 1,
  "evtSbscPathCd": "text",
  "tubaBankCd": "text",
  "tubaDepositorNm": "text",
  "tubaVirActnNo": "text",
  "tubaDptAmt": 1,
  "tubaDptDtm": "2026-01-01T00:00:00.000Z",
  "deliHdcCd": "text",
  "deliInvNo": "text",
  "mailSndCnt": 1,
  "bbcNo": "text",
  "lotCondSeq": "text",
  "etcGftDlvpNo": "text",
  "etcGftStatCd": "text",
  "paysYn": "text",
  "paysDtm": "2026-01-01T00:00:00.000Z",
  "trnsYn": "text",
  "rcvmnNm": "text",
  "zipNo": "text",
  "zipAddr": "text",
  "dtlAddr": "text",
  "cellSctNo": "text",
  "cellTxnoNo": "text",
  "cellEndNo": "text",
  "deliMsg": "text",
  "comnFrdrEtcMethod": "text",
  "comnFrdrPwd": "text",
  "comnFrdrCogoMethodCd": "text",
  "evtFvrSeq": "text"
}
200

OK

text

Retrieve Event Purchase Gift Entry History

get

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

Query parameters
siteNostringOptional

string

Example: 1
pageIdxstringRequired

string

Example: 1
rowsPerPagestringRequired

string

Example: 10
periodGbstringRequired

string

Example: 0
filteringGbstringOptional

string

Example: 2
Header parameters
AuthorizationanyOptional

Access Token

Responses
200

Gift entry history retrieved successfully

*/*

Event Participation List Response

allPageCntinteger · int32Optional

Total Page Count

Example: 10
curPageNointeger · int32Optional

Current Page No.

Example: 1
purEvtCntinteger · int32Optional

Automatic Entry Count

Example: 3
get/v1/marketing/getPurFreeEventList
GET /api/event/v1/marketing/getPurFreeEventList?pageIdx=text&rowsPerPage=text&periodGb=text HTTP/1.1
Host: api-event.x2bee.com/
Accept: */*

{
  "allPageCnt": 10,
  "curPageNo": 1,
  "purEvtCnt": 3,
  "evtTrgmnInfo": [
    {
      "evtNo": 12345,
      "evtNm": "이벤트명 Sample!",
      "evtStrDtm": "2026-01-01",
      "evtEndDtm": "2026-01-01T00:00:00.000Z",
      "evtPrgsStatCd": "01",
      "evtPrgsStatNm": "임시등록",
      "orgEvtPrgsStatCd": "01",
      "evtUrlAddr": "/url",
      "evtBnrPathNm": "/url",
      "evtBnrFileNm": "이벤트배너명.jpeg",
      "evtBnrAltCont": "이벤트배너이미지 대체텍스트",
      "pcEvtBnrPathNm": "/url",
      "pcEvtBnrFileNm": "PC이벤트배너명.png",
      "pcEvtBnrAltCont": "PC용이벤트배너이미지 대체텍스트",
      "evtTrgmnGbCd": "01",
      "winDtm": "2023-08-21",
      "winRnk": 1,
      "evtFvrTypCd": 10,
      "evtGoodsNm": "상품권 50000원권",
      "payMilg": 500,
      "pmgdSndDt": "2023-08-23",
      "payDt": "2023-08-25",
      "zipNo": 5837,
      "zipAddr": "서울 송파구 법원로9길 26",
      "dtlAddr": "비즈니스파크",
      "cellSctNo": "010",
      "cellTxnoNo": 1234,
      "cellEndNo": 5678,
      "rcvmnNm": "플래티어",
      "etcGftStatCd": 10,
      "etcGftStatNm": 10,
      "purAmtEvtPromoYn": "N",
      "buyAmt": 50000,
      "purAmt": 30000,
      "evtLgrpCd": 10,
      "evtMgrpCd": 13,
      "goodsImgPath": "/url",
      "evetTermDesc": "행사기간설명 Sample",
      "evetCondDesc": "행사조건설명 Sample",
      "etcDesc1": "기타설명1 Sample",
      "etcDesc2": "기타설명2 Sample",
      "etcDesc3": "기타설명3 Sample",
      "etcDesc4": "기타설명4 Sample",
      "etcDesc5": "기타설명5 Sample",
      "paysTermDesc": "지급기간설명 Sample",
      "paysYn": "N",
      "paysDtm": "2023-08-22",
      "winCnclDtm": "2023-08-23",
      "trgmnSeq": 1,
      "pmgdSndDtCal": 5,
      "etcGftDlvpNo": 123,
      "trnsYn": "N",
      "hdcCd": 22,
      "invNo": 10000293,
      "sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "sbscPsbMinOrdAmt": 1000,
      "orderList": [
        {
          "ordNo": "20230809O007943",
          "ordDtm": "2026-01-01T00:00:00.000Z",
          "ordAmt": 510000
        }
      ]
    }
  ]
}

Retrieve Event Participation History

get

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

Query parameters
siteNostringOptional

string

Example: 1
pageIdxstringRequired

string

Example: 1
rowsPerPagestringRequired

string

Example: 10
periodGbstringRequired

string

Example: 0
Header parameters
AuthorizationanyOptional

Access Token

Responses
200

Event participation history retrieved successfully

*/*

Event Participation List Response

allPageCntinteger · int32Optional

Total Page Count

Example: 10
curPageNointeger · int32Optional

Current Page No.

Example: 1
purEvtCntinteger · int32Optional

Automatic Entry Count

Example: 3
get/v1/marketing/getMyEventEntryList
GET /api/event/v1/marketing/getMyEventEntryList?pageIdx=text&rowsPerPage=text&periodGb=text HTTP/1.1
Host: api-event.x2bee.com/
Accept: */*

{
  "allPageCnt": 10,
  "curPageNo": 1,
  "purEvtCnt": 3,
  "evtTrgmnInfo": [
    {
      "evtNo": 12345,
      "evtNm": "이벤트명 Sample!",
      "evtStrDtm": "2026-01-01",
      "evtEndDtm": "2026-01-01T00:00:00.000Z",
      "evtPrgsStatCd": "01",
      "evtPrgsStatNm": "임시등록",
      "orgEvtPrgsStatCd": "01",
      "evtUrlAddr": "/url",
      "evtBnrPathNm": "/url",
      "evtBnrFileNm": "이벤트배너명.jpeg",
      "evtBnrAltCont": "이벤트배너이미지 대체텍스트",
      "pcEvtBnrPathNm": "/url",
      "pcEvtBnrFileNm": "PC이벤트배너명.png",
      "pcEvtBnrAltCont": "PC용이벤트배너이미지 대체텍스트",
      "evtTrgmnGbCd": "01",
      "winDtm": "2023-08-21",
      "winRnk": 1,
      "evtFvrTypCd": 10,
      "evtGoodsNm": "상품권 50000원권",
      "payMilg": 500,
      "pmgdSndDt": "2023-08-23",
      "payDt": "2023-08-25",
      "zipNo": 5837,
      "zipAddr": "서울 송파구 법원로9길 26",
      "dtlAddr": "비즈니스파크",
      "cellSctNo": "010",
      "cellTxnoNo": 1234,
      "cellEndNo": 5678,
      "rcvmnNm": "플래티어",
      "etcGftStatCd": 10,
      "etcGftStatNm": 10,
      "purAmtEvtPromoYn": "N",
      "buyAmt": 50000,
      "purAmt": 30000,
      "evtLgrpCd": 10,
      "evtMgrpCd": 13,
      "goodsImgPath": "/url",
      "evetTermDesc": "행사기간설명 Sample",
      "evetCondDesc": "행사조건설명 Sample",
      "etcDesc1": "기타설명1 Sample",
      "etcDesc2": "기타설명2 Sample",
      "etcDesc3": "기타설명3 Sample",
      "etcDesc4": "기타설명4 Sample",
      "etcDesc5": "기타설명5 Sample",
      "paysTermDesc": "지급기간설명 Sample",
      "paysYn": "N",
      "paysDtm": "2023-08-22",
      "winCnclDtm": "2023-08-23",
      "trgmnSeq": 1,
      "pmgdSndDtCal": 5,
      "etcGftDlvpNo": 123,
      "trnsYn": "N",
      "hdcCd": 22,
      "invNo": 10000293,
      "sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "sbscPsbMinOrdAmt": 1000,
      "orderList": [
        {
          "ordNo": "20230809O007943",
          "ordDtm": "2026-01-01T00:00:00.000Z",
          "ordAmt": 510000
        }
      ]
    }
  ]
}
PreviousEvent Entry
NextEvent Common

Last updated