Event Information Management

Upload Event Attachment

post

Function Description

• Uploads event-related attachments to S3.

---

Detailed Description

• Uploads event-related attachments to S3.

• Returns the S3 path of the uploaded file.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

evtBnrFilestring · binaryRequired

Responses

200

Success

*/*

Other propertiesstringOptional

900

Failure

*/*

post/v2/marketing/eventMgmt/upLoadEvtBnrFile

POST /api/bo/v2/marketing/eventMgmt/upLoadEvtBnrFile HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "evtBnrFile": "binary"
}

{
  "ANY_ADDITIONAL_PROPERTY": "text"
}

Prize Payment Request

post

Function Description

• Requests prize payment.

---

Detailed Description

• **The event number (evtNo) is required.

• Processes the prize payment for entrants of the event.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

qryGbCdstringOptional

Excel Download Reason Code

indInfoQryCausstringOptional

Excel Download Reason

trgmnSeqstringOptional

Target Sequence No.

Example: 1

evtTrgmnGbCdstring · enumOptional

Event Target Classification Code (EV012)

Example: 04Possible values:

mbrNostringOptional

Member No.

Example: 100000

winRnkstringOptional

Winning Rank

Example: 1

winCnclCausContstringOptional

Winning Cancellation Reason Content

Example: 주문취소하여구매금액미달

evtNostringOptional

Event No.

Example: 15322

waitRnkstringOptional

Waitlist Rank

Example: 10

intxstringOptional

Income Tax

Example: 500000

citxstringOptional

Local Income Tax

Example: 30000

ordSumAmtstringOptional

Total Order Amount

Example: 50000

cfmOrdAmtstringOptional

Confirmed Order Amount

Example: 40000

evtSbscPathCdstring · enumOptional

Event Application Channel Code (OM007)

Example: 20Possible values:

tubaBankCdstring · enumOptional

Tax and Public Dues Bank Code (OM026)

Example: 104Possible values:

tubaDepositorNmstringOptional

Tax Withholding Account Holder Name

Example: 김아무개

tubaVirActnNostringOptional

Tax Withholding Virtual Account No.

Example: 11111-222-333-44

tubaDptAmtstringOptional

Tax Withholding Deposit Amount

Example: 50000

deliHdcCdstring · enumOptional

Delivery Courier Company Code (LO005)

Example: 10Possible values:

deliInvNostringOptional

Delivery Tracking No.

Example: 1141212314

mailSndCntstringOptional

Email Send Count

Example: 10

bbcNostringOptional

Post Number

Example: 114

lotCondSeqstringOptional

Drawing Condition Sequence No.

Example: 2

mbrNoListstring[]Optional

Member No. List

Example: [10000000,10000001,10000002]

mbrNmstringOptional

Member Name

Example: 홍길동

loginIdstringOptional

Member ID

Example: abc

cellNostringOptional

Mobile Phone Number

Example: 01011112222

cellSctNostringOptional

Mobile Phone Prefix Code

Example: 010

cellTxnoNostringOptional

Mobile Phone Exchange Code

Example: 1111

cellEndNostringOptional

Mobile Phone Last Digits

Example: 2222

lotObjCdstring · enumOptional

Drawing Purpose (EV022)

Example: 10Possible values:

lotExcpStafYnstringOptional

Exclude Employees from Drawing Target Status

Example: Y

trgmnSeqListstring[]Optional

Entry No.

Example: [100,101,102,103]

trgmnSeqArrstringOptional

Entry No.

Example: 100

lotTargetNuminteger · int32Optional

Number of Drawing Targets

Example: 100

lotLimitNuminteger · int32Optional

Number of Winners by Prize Benefit

Example: 50

evtMgrpCdstring · enumOptional

Event Type (EV002)

Example: 30Possible values:

buyAmtinteger · int32Optional

Purchase Amount

Example: 50000

setTypestringOptional

Win & Win Cancellation

Example: 10

lotTypestringOptional

Drawing Type: Draw:LL, Redraw:RL, Add to Waitlist:WA, Waitlist Draw:WL, Waitlist Win Cancellation:WC, Waitlist Redraw:WR

sndMethCdstring · enumOptional

Send Method Code (EV013)

Example: 01Possible values:

rcvmnNmstringOptional

Prize Recipient Name

Example: 김아무개

deliZipNostringOptional

Prize Delivery Address Postal Code

Example: 12345

deliZipAddrstringOptional

Prize Receiving Address

Example: 서울시 아무구 아무동 1번

deliZipDtlAddrstringOptional

Prize Receiving Address

Example: 아무건물 302호

deliTelNostringOptional

Prize Recipient Phone No.

Example: 021234567

deliTelRgnNostringOptional

Prize Recipient Phone Area Code

Example: 02

deliTelTxnoNostringOptional

Prize Recipient Phone Exchange No.

Example: 123

deliTelEndNostringOptional

Prize Recipient Phone Last Digits

Example: 4567

deliCellNostringOptional

Prize Recipient Mobile Phone No.

Example: 01011112222

deliCellSctNostringOptional

Prize Delivery Address Mobile Phone Prefix

Example: 010

deliCellTxnoNostringOptional

Prize Delivery Address Mobile Phone Middle Digits

Example: 1111

deliCellEndNostringOptional

Prize Delivery Address Mobile Phone Last Digits

Example: 2222

realGoodsstringOptional

Physical Prize

Example: 1002304

evtNmstringOptional

Event Name

Example: 이벤트

aempIdstringOptional

Event Manager

Example: 1002304

startDatestringOptional

Entry Period Start Date

endDatestringOptional

Entry Period End Date

excelHeaderstringOptional

Excel Header

winCnclDtmstring · date-timeOptional

Winning Cancellation Date/Time

winDtmstring · date-timeOptional

Winning Date/Time

myCertiDtmstring · date-timeOptional

Identity Verification Date/Time

sbscAplyDtmstring · date-timeOptional

Application Date/Time

wtpsSltDtmstring · date-timeOptional

Waitlist Selection Date/Time

tubaDptDtmstring · date-timeOptional

Tax Withholding Deposit Date/Time

buyStrDtmstring · date-timeOptional

Purchase Period Start Date/Time

buyEndDtmstring · date-timeOptional

Purchase Period End Date/Time

alarmStatusYnstringOptional

Notification Talk/Notification Usage Status

Example: Y

evtFvrTypCdstring · enumOptional

Event Benefit Type Code (EV011)

Example: 10Possible values:

sbscPsbMinOrdAmtnumberOptional

Minimum Order Payment Amount for Entry

Responses

200

Prize Payment Request Succeeded

No content

900

Prize Payment Request Failed

*/*

post/v2/marketing/eventMgmt/saveEventMgmtGiveaWayPaymentRequest

POST /api/bo/v2/marketing/eventMgmt/saveEventMgmtGiveaWayPaymentRequest HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1774

{
  "qryGbCd": "text",
  "indInfoQryCaus": "text",
  "trgmnSeq": 1,
  "evtTrgmnGbCd": "04",
  "mbrNo": 100000,
  "winRnk": 1,
  "winCnclCausCont": "주문취소하여구매금액미달",
  "evtNo": 15322,
  "waitRnk": 10,
  "intx": 500000,
  "citx": 30000,
  "ordSumAmt": 50000,
  "cfmOrdAmt": 40000,
  "evtSbscPathCd": 20,
  "tubaBankCd": 104,
  "tubaDepositorNm": "김아무개",
  "tubaVirActnNo": "11111-222-333-44",
  "tubaDptAmt": 50000,
  "deliHdcCd": 10,
  "deliInvNo": 1141212314,
  "mailSndCnt": 10,
  "bbcNo": 114,
  "lotCondSeq": 2,
  "mbrNoList": [
    10000000,
    10000001,
    10000002
  ],
  "mbrNm": "홍길동",
  "loginId": "abc",
  "cellNo": "01011112222",
  "cellSctNo": "010",
  "cellTxnoNo": 1111,
  "cellEndNo": 2222,
  "lotObjCd": 10,
  "lotExcpStafYn": "Y",
  "trgmnSeqList": [
    100,
    101,
    102,
    103
  ],
  "trgmnSeqArr": 100,
  "lotTargetNum": 100,
  "lotLimitNum": 50,
  "evtMgrpCd": 30,
  "buyAmt": 50000,
  "setType": 10,
  "lotType": "text",
  "sndMethCd": "01",
  "rcvmnNm": "김아무개",
  "deliZipNo": 12345,
  "deliZipAddr": "서울시 아무구 아무동 1번",
  "deliZipDtlAddr": "아무건물 302호",
  "deliTelNo": "021234567",
  "deliTelRgnNo": "02",
  "deliTelTxnoNo": 123,
  "deliTelEndNo": 4567,
  "deliCellNo": "01011112222",
  "deliCellSctNo": "010",
  "deliCellTxnoNo": 1111,
  "deliCellEndNo": 2222,
  "realGoods": 1002304,
  "evtNm": "이벤트",
  "aempId": 1002304,
  "startDate": "text",
  "endDate": "text",
  "excelHeader": "text",
  "winCnclDtm": "2026-01-01T00:00:00.000Z",
  "winDtm": "2026-01-01T00:00:00.000Z",
  "myCertiDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
  "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
  "tubaDptDtm": "2026-01-01T00:00:00.000Z",
  "buyStrDtm": "2026-01-01T00:00:00.000Z",
  "buyEndDtm": "2026-01-01T00:00:00.000Z",
  "alarmStatusYn": "Y",
  "evtFvrTypCd": 10,
  "sbscPsbMinOrdAmt": 1,
  "dataList": [
    {
      "evtFvrSeq": 1,
      "evtNo": 15322,
      "mbrNo": 1000000,
      "lotGb": "04",
      "trgmnSeq": 1,
      "loginId": "abde",
      "mbrNm": "김아무개",
      "mbrSexGb": "M",
      "mbrAge": 19,
      "cellNo": "01011112222"
    }
  ]
}

No content

Change Event Management Status

post

Function Description

• Changes the event management status.

---

Detailed Description

• Event No. (evtNo), Event Progress Status (evtPrgsStat) are required.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

siteNostringOptional

Site No.

Example: 1

statestringOptional

Data Value State Status (U if data value exists / I if not)

Example: U

reSearchPagestringOptional

Parent Window Grid Search Type Value

periodGbstringOptional

Period Search Type: 0: Start Date, 1: End Date, 2: Drawing Date, 3: Send Date

Example: 0

startDatestring · dateOptional

Start Date

endDatestring · dateOptional

End Date

dateSelectstringOptional

Date Selection Option

Example: all_day

evtTypstringOptional

Event Type

argSelectTypestringOptional

Selection Type (1: Single, N: Multiple)

Example: 1

evtNmstring · min: 1Required

Event Name

Example: 단순클릭 이벤트

evtNostringOptional

Event No.

Example: 15322

uprFixYnstringOptional

Top Position Status

Example: Y

evtUrlAddrstringOptional

Event URL

Example: /event/15322

deptCdstring · min: 1Required

Managing Department Code

Example: 10130

aempIdstringOptional

Person in Charge ID

Example: abcd

dispYnstring · min: 1Required

Display Status

Example: Y

evtPrgsStatstring · enumOptional

Management Status (EV005)

Example: 01Possible values:

adveWrdContstringOptional

Event Promotional Copy

Example: 이벤트홍보

evtSchTagstringOptional

Search Tag

Example: 이벤트

expYnstringOptional

Event Display

Example: Y

mbrGbCdArrstring · enumOptional

Display Grade Type Code (ME002)

Possible values:

mbrGradeCdArrstring · enumOptional

Display Grade Type Code (ME008)

Example: 10Possible values:

evtSbscPsbCdstring · enumOptional

Event Entry Eligibility Code (EV006)

Example: 01Possible values:

evtExpNmCdstring · enumOptional

Event Display Name Code (EV003)

Example: 01Possible values:

indInfoMkusAgrYnstringOptional

Personal Information Usage Consent Status

Example: N

indInfoMkusAgmtstringOptional

Personal Information Usage Terms

indInfoThprPofAgrYnstringOptional

Personal Information Third-Party Provision Consent Status

Example: N

indInfoThprPofAgmtstringOptional

Personal Information Third-Party Provision Terms

evtLgrpCdstring · enum · min: 1Required

Event Type Major Category Code (EV001)

Example: 20Possible values:

evtMgrpCdstring · enum · min: 1Required

Event Type Subcategory Code (EV002)

Example: 30Possible values:

mbrGradeCd2string · enumOptional

Applicant Member Grade (ME008)

Example: 10Possible values:

evtGbCdstring · enumOptional

Event Type Code (EV026)

Example: 01Possible values:

sbscCntLmtCdstring · enum · min: 1Required

Number of Entries (EV007)

Example: 02Possible values:

evtObjCdstring · enum · min: 1Required

Event Purpose (EV004)

Example: 01Possible values:

purAmtEvtPromoYnstringOptional

Purchase Amount Event Promotion Status

Example: N

lotDtstringOptional

Drawing/Confirmation Date

winAncmDtstringOptional

Winner Announcement Date/Time

winAncmDispYnstringOptional

Winner Announcement Display

Example: Y

payDtstringOptional

Point Payout Date/Time

pmgdSndDtstringOptional

Gift Shipment Date

evtBnrPathNmstring · min: 1Required

Event Banner Path

Example: files/test/../../test.png

evtBnrFileNmstring · min: 1Required

Event Banner File Name

Example: test.png

evtBnrAltContstringOptional

Event Banner Alt Text

Example: 배너이미지 대체 텍스트

pcEvtBnrPathNmstring · min: 1Required

Event Banner Path Name (PC)

Example: files/test/../../test.png

pcEvtBnrFileNmstring · min: 1Required

Event Banner File Name (PC)

Example: test.png

pcEvtBnrAltContstringOptional

Event Banner Alt Text for PC

Example: 배너이미지 PC용 대체 텍스트

aplySitesstring[]Optional

Insert Site Information (String)

rnkMgrYnstringOptional

Ranking Management Status

Example: N

winWtpsCntstringOptional

Number of Winners on Waitlist

Example: 100

pmgdRcvProeContstringOptional

Prize Receiving Procedure Content

Example: 경품수령절차내용

evetTermDescstringOptional

Event Period Description

Example: 행사기간설명

evetCondDescstringOptional

Event Condition Description

Example: 행사조건설명

paysTermDescstringOptional

Payout Period Description

Example: 지급기간설명

evtTmplUseYnstringOptional

Event Template Usage Status

Example: Y

tmplUseGbstringOptional

Template Selection Template No.

tmplDtlCmpsCdArrstring · enumOptional

Template Detail Classification Code (EV014)

Example: 10Possible values:

htmlFileContstringOptional

Template Content

pcHtmlFileContstringOptional

Template Content for PC

evtExpMsgstringOptional

Event Display Message

Example: 이벤트 노출 메시지

atndMtrstringOptional

Precautions

Example: 유의사항

acdnUseYnstringOptional

Accordion UI Usage Status

Example: Y

custCntrGdWrdContstringOptional

Customer Center Guide Message Content

Example: 고객센터안내문구내용

evtNoListstring[]Optional

Event No. Array

Example: [15692,15652,15562,15382]

evtStrDtmstring · date-timeRequired

Event Period Start Date

evtEndDtmstring · date-timeRequired

Event Period End Date

buyStrDtmstring · date-timeOptional

Purchase Period Start Date

buyEndDtmstring · date-timeOptional

Purchase Period End Date

sbscAplyStrDtmstring · date-timeRequired

Application Period Start Date

sbscAplyEndDtmstring · date-timeRequired

Application Period End Date

tubaDptStrDtstring · date-timeOptional

Withholding Tax Deposit Start Date/Time

tubaDptEndDtstring · date-timeOptional

Withholding Tax Deposit End Date/Time

sbscPsbMinOrdAmtinteger · int64Optional

Minimum Order Payment Amount

Responses

200

Management Status Change Success

No content

900

Management Status Change Failure

*/*

post/v1/marketing/eventMgmt/updateEventStat

POST /api/bo/v1/marketing/eventMgmt/updateEventStat HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2910

{
  "siteNo": 1,
  "state": "U",
  "reSearchPage": "text",
  "periodGb": 0,
  "startDate": "2026-01-01",
  "endDate": "2026-01-01",
  "dateSelect": "all_day",
  "evtTyp": "text",
  "argSelectType": 1,
  "evtNm": "단순클릭 이벤트",
  "evtNo": 15322,
  "uprFixYn": "Y",
  "evtUrlAddr": "/event/15322",
  "deptCd": 10130,
  "aempId": "abcd",
  "dispYn": "Y",
  "evtPrgsStat": "01",
  "adveWrdCont": "이벤트홍보",
  "evtSchTag": "이벤트",
  "expYn": "Y",
  "mbrGbCdArr": "UNION_MEMBER",
  "mbrGradeCdArr": 10,
  "evtSbscPsbCd": "01",
  "evtExpNmCd": "01",
  "indInfoMkusAgrYn": "N",
  "indInfoMkusAgmt": "text",
  "indInfoThprPofAgrYn": "N",
  "indInfoThprPofAgmt": "text",
  "evtLgrpCd": 20,
  "evtMgrpCd": 30,
  "mbrGradeCd2": 10,
  "evtGbCd": "01",
  "sbscCntLmtCd": "02",
  "evtObjCd": "01",
  "purAmtEvtPromoYn": "N",
  "lotDt": "text",
  "winAncmDt": "text",
  "winAncmDispYn": "Y",
  "payDt": "text",
  "pmgdSndDt": "text",
  "evtBnrPathNm": "files/test/../../test.png",
  "evtBnrFileNm": "test.png",
  "evtBnrAltCont": "배너이미지 대체 텍스트",
  "pcEvtBnrPathNm": "files/test/../../test.png",
  "pcEvtBnrFileNm": "test.png",
  "pcEvtBnrAltCont": "배너이미지 PC용 대체 텍스트",
  "loltList": [
    {
      "evtNo": 15322,
      "evtMgrpCd": 30,
      "aplyRnk": 1,
      "roltPayPnum": 100,
      "roltPrbl": 10,
      "payPoint": 200
    }
  ],
  "attenList": [
    {
      "evtNo": 15322,
      "evtMgrpCd": 30,
      "aplyRnk": 1,
      "roltPayPnum": 100,
      "roltPrbl": 10,
      "payPoint": 200
    }
  ],
  "questList": [
    {
      "evtNo": 15322,
      "questNo": 1,
      "questGbCd": 20,
      "questCont": "이것은 사과입니까?",
      "questQestCnt": 4,
      "cawrCont": "네",
      "dupAnsYn": "Y",
      "mdtyQuestYn": "Y",
      "questExpltList": [
        {
          "evtNo": 15322,
          "questNo": 1,
          "questExplNo": 3,
          "questExplCont": "네",
          "questBnrPathNm": "files/test/../../test.png",
          "questBnrFileNm": "test.png"
        }
      ]
    }
  ],
  "pmgdList": [
    {
      "evtNo": 15322,
      "evtFvrSeq": 1,
      "winRnk": 1,
      "evtFvrTypCd": 10,
      "buyAmt": 50000,
      "payMilg": 50000,
      "evtGoodsNm": "테스트상품",
      "promoNo": 1000000,
      "goodsNo": 1000000,
      "payPnumCnt": 100,
      "pmgdAmt": 10000,
      "winmnChrgYn": "Y",
      "tuba": 2000,
      "winWtpsCnt": 100,
      "payAmt": 100000,
      "etcDesc1": "설명1",
      "etcDesc2": "설명2",
      "etcDesc3": "설명3",
      "etcDesc4": "설명4",
      "etcDesc5": "설명5"
    }
  ],
  "aplyList": [
    {
      "evtNo": "text",
      "custFvrAplyGbCd": 10,
      "custFvrAplyTypCd": 10,
      "fvrTgtNo": "text",
      "siteNm": "text",
      "siteDom": "text",
      "applyCont": "text"
    }
  ],
  "aplySites": [
    "text"
  ],
  "rnkMgrYn": "N",
  "winWtpsCnt": 100,
  "pmgdRcvProeCont": "경품수령절차내용",
  "evetTermDesc": "행사기간설명",
  "evetCondDesc": "행사조건설명",
  "paysTermDesc": "지급기간설명",
  "evtTmplUseYn": "Y",
  "tmplUseGb": "text",
  "tmplDtlCmpsCdArr": 10,
  "htmlFileCont": "text",
  "pcHtmlFileCont": "text",
  "evtExpMsg": "이벤트 노출 메시지",
  "atndMtr": "유의사항",
  "acdnUseYn": "Y",
  "custCntrGdWrdCont": "고객센터안내문구내용",
  "evtNoList": [
    15692,
    15652,
    15562,
    15382
  ],
  "evtStrDtm": "2026-01-01T00:00:00.000Z",
  "evtEndDtm": "2026-01-01T00:00:00.000Z",
  "buyStrDtm": "2026-01-01T00:00:00.000Z",
  "buyEndDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
  "tubaDptStrDt": "2026-01-01T00:00:00.000Z",
  "tubaDptEndDt": "2026-01-01T00:00:00.000Z",
  "sbscPsbMinOrdAmt": 1
}

No content

Save Test Group Management Grid

post

Function Description

• Test Group Management - Saves the grid.

---

Detailed Description

• Test Group Info (CcTestGrpInfoRequest) is required.

• Registers/modifies/deletes rows in the test group management grid.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

Responses

200

Grid Saved Successfully

*/*

stringOptional

900

Grid Save Failed

*/*

post/v1/marketing/eventMgmt/saveTestGrpInfoMgmt

POST /api/bo/v1/marketing/eventMgmt/saveTestGrpInfoMgmt HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 510

{
  "all": [
    {
      "testGrpNo": 11112,
      "testUserNm": "test",
      "cellSctNo": "010",
      "cellTxnoNo": 1111,
      "cellEndNo": 2222,
      "emailAddr": "[e-mail]"
    }
  ],
  "create": [
    {
      "testGrpNo": 11112,
      "testUserNm": "test",
      "cellSctNo": "010",
      "cellTxnoNo": 1111,
      "cellEndNo": 2222,
      "emailAddr": "[e-mail]"
    }
  ],
  "update": [
    {
      "testGrpNo": 11112,
      "testUserNm": "test",
      "cellSctNo": "010",
      "cellTxnoNo": 1111,
      "cellEndNo": 2222,
      "emailAddr": "[e-mail]"
    }
  ],
  "delete": [
    {
      "testGrpNo": 11112,
      "testUserNm": "test",
      "cellSctNo": "010",
      "cellTxnoNo": 1111,
      "cellEndNo": 2222,
      "emailAddr": "[e-mail]"
    }
  ]
}

text

Select Event Winner/Cancellation

post

Function Description

• Selects entrants of the event as winners or cancels their winning status.

---

Detailed Description

• Event No. (evtNo), Event Benefit Sequence No. (evtFvrSeq), Member No. (mbrNo) are required.

• Selects entrants of the event as winners or cancels their winning status using the event number (evtNo) parameter.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

qryGbCdstringOptional

Excel Download Reason Code

indInfoQryCausstringOptional

Excel Download Reason

trgmnSeqstringOptional

Target Sequence No.

Example: 1

evtTrgmnGbCdstring · enumOptional

Event Target Classification Code (EV012)

Example: 04Possible values:

mbrNostringOptional

Member No.

Example: 100000

winRnkstringOptional

Winning Rank

Example: 1

winCnclCausContstringOptional

Winning Cancellation Reason Content

Example: 주문취소하여구매금액미달

evtNostringOptional

Event No.

Example: 15322

waitRnkstringOptional

Waitlist Rank

Example: 10

intxstringOptional

Income Tax

Example: 500000

citxstringOptional

Local Income Tax

Example: 30000

ordSumAmtstringOptional

Total Order Amount

Example: 50000

cfmOrdAmtstringOptional

Confirmed Order Amount

Example: 40000

evtSbscPathCdstring · enumOptional

Event Application Channel Code (OM007)

Example: 20Possible values:

tubaBankCdstring · enumOptional

Tax and Public Dues Bank Code (OM026)

Example: 104Possible values:

tubaDepositorNmstringOptional

Tax Withholding Account Holder Name

Example: 김아무개

tubaVirActnNostringOptional

Tax Withholding Virtual Account No.

Example: 11111-222-333-44

tubaDptAmtstringOptional

Tax Withholding Deposit Amount

Example: 50000

deliHdcCdstring · enumOptional

Delivery Courier Company Code (LO005)

Example: 10Possible values:

deliInvNostringOptional

Delivery Tracking No.

Example: 1141212314

mailSndCntstringOptional

Email Send Count

Example: 10

bbcNostringOptional

Post Number

Example: 114

lotCondSeqstringOptional

Drawing Condition Sequence No.

Example: 2

mbrNoListstring[]Optional

Member No. List

Example: [10000000,10000001,10000002]

mbrNmstringOptional

Member Name

Example: 홍길동

loginIdstringOptional

Member ID

Example: abc

cellNostringOptional

Mobile Phone Number

Example: 01011112222

cellSctNostringOptional

Mobile Phone Prefix Code

Example: 010

cellTxnoNostringOptional

Mobile Phone Exchange Code

Example: 1111

cellEndNostringOptional

Mobile Phone Last Digits

Example: 2222

lotObjCdstring · enumOptional

Drawing Purpose (EV022)

Example: 10Possible values:

lotExcpStafYnstringOptional

Exclude Employees from Drawing Target Status

Example: Y

trgmnSeqListstring[]Optional

Entry No.

Example: [100,101,102,103]

trgmnSeqArrstringOptional

Entry No.

Example: 100

lotTargetNuminteger · int32Optional

Number of Drawing Targets

Example: 100

lotLimitNuminteger · int32Optional

Number of Winners by Prize Benefit

Example: 50

evtMgrpCdstring · enumOptional

Event Type (EV002)

Example: 30Possible values:

buyAmtinteger · int32Optional

Purchase Amount

Example: 50000

setTypestringOptional

Win & Win Cancellation

Example: 10

lotTypestringOptional

Drawing Type: Draw:LL, Redraw:RL, Add to Waitlist:WA, Waitlist Draw:WL, Waitlist Win Cancellation:WC, Waitlist Redraw:WR

sndMethCdstring · enumOptional

Send Method Code (EV013)

Example: 01Possible values:

rcvmnNmstringOptional

Prize Recipient Name

Example: 김아무개

deliZipNostringOptional

Prize Delivery Address Postal Code

Example: 12345

deliZipAddrstringOptional

Prize Receiving Address

Example: 서울시 아무구 아무동 1번

deliZipDtlAddrstringOptional

Prize Receiving Address

Example: 아무건물 302호

deliTelNostringOptional

Prize Recipient Phone No.

Example: 021234567

deliTelRgnNostringOptional

Prize Recipient Phone Area Code

Example: 02

deliTelTxnoNostringOptional

Prize Recipient Phone Exchange No.

Example: 123

deliTelEndNostringOptional

Prize Recipient Phone Last Digits

Example: 4567

deliCellNostringOptional

Prize Recipient Mobile Phone No.

Example: 01011112222

deliCellSctNostringOptional

Prize Delivery Address Mobile Phone Prefix

Example: 010

deliCellTxnoNostringOptional

Prize Delivery Address Mobile Phone Middle Digits

Example: 1111

deliCellEndNostringOptional

Prize Delivery Address Mobile Phone Last Digits

Example: 2222

realGoodsstringOptional

Physical Prize

Example: 1002304

evtNmstringOptional

Event Name

Example: 이벤트

aempIdstringOptional

Event Manager

Example: 1002304

startDatestringOptional

Entry Period Start Date

endDatestringOptional

Entry Period End Date

excelHeaderstringOptional

Excel Header

winCnclDtmstring · date-timeOptional

Winning Cancellation Date/Time

winDtmstring · date-timeOptional

Winning Date/Time

myCertiDtmstring · date-timeOptional

Identity Verification Date/Time

sbscAplyDtmstring · date-timeOptional

Application Date/Time

wtpsSltDtmstring · date-timeOptional

Waitlist Selection Date/Time

tubaDptDtmstring · date-timeOptional

Tax Withholding Deposit Date/Time

buyStrDtmstring · date-timeOptional

Purchase Period Start Date/Time

buyEndDtmstring · date-timeOptional

Purchase Period End Date/Time

alarmStatusYnstringOptional

Notification Talk/Notification Usage Status

Example: Y

evtFvrTypCdstring · enumOptional

Event Benefit Type Code (EV011)

Example: 10Possible values:

sbscPsbMinOrdAmtnumberOptional

Minimum Order Payment Amount for Entry

Responses

200

Winner/Cancellation Selection Success

*/*

stringOptional

900

Winner/Cancellation Selection Failure

*/*

post/v1/marketing/eventMgmt/saveEvtTrgmnSelectedProc

POST /api/bo/v1/marketing/eventMgmt/saveEvtTrgmnSelectedProc HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1774

{
  "qryGbCd": "text",
  "indInfoQryCaus": "text",
  "trgmnSeq": 1,
  "evtTrgmnGbCd": "04",
  "mbrNo": 100000,
  "winRnk": 1,
  "winCnclCausCont": "주문취소하여구매금액미달",
  "evtNo": 15322,
  "waitRnk": 10,
  "intx": 500000,
  "citx": 30000,
  "ordSumAmt": 50000,
  "cfmOrdAmt": 40000,
  "evtSbscPathCd": 20,
  "tubaBankCd": 104,
  "tubaDepositorNm": "김아무개",
  "tubaVirActnNo": "11111-222-333-44",
  "tubaDptAmt": 50000,
  "deliHdcCd": 10,
  "deliInvNo": 1141212314,
  "mailSndCnt": 10,
  "bbcNo": 114,
  "lotCondSeq": 2,
  "mbrNoList": [
    10000000,
    10000001,
    10000002
  ],
  "mbrNm": "홍길동",
  "loginId": "abc",
  "cellNo": "01011112222",
  "cellSctNo": "010",
  "cellTxnoNo": 1111,
  "cellEndNo": 2222,
  "lotObjCd": 10,
  "lotExcpStafYn": "Y",
  "trgmnSeqList": [
    100,
    101,
    102,
    103
  ],
  "trgmnSeqArr": 100,
  "lotTargetNum": 100,
  "lotLimitNum": 50,
  "evtMgrpCd": 30,
  "buyAmt": 50000,
  "setType": 10,
  "lotType": "text",
  "sndMethCd": "01",
  "rcvmnNm": "김아무개",
  "deliZipNo": 12345,
  "deliZipAddr": "서울시 아무구 아무동 1번",
  "deliZipDtlAddr": "아무건물 302호",
  "deliTelNo": "021234567",
  "deliTelRgnNo": "02",
  "deliTelTxnoNo": 123,
  "deliTelEndNo": 4567,
  "deliCellNo": "01011112222",
  "deliCellSctNo": "010",
  "deliCellTxnoNo": 1111,
  "deliCellEndNo": 2222,
  "realGoods": 1002304,
  "evtNm": "이벤트",
  "aempId": 1002304,
  "startDate": "text",
  "endDate": "text",
  "excelHeader": "text",
  "winCnclDtm": "2026-01-01T00:00:00.000Z",
  "winDtm": "2026-01-01T00:00:00.000Z",
  "myCertiDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
  "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
  "tubaDptDtm": "2026-01-01T00:00:00.000Z",
  "buyStrDtm": "2026-01-01T00:00:00.000Z",
  "buyEndDtm": "2026-01-01T00:00:00.000Z",
  "alarmStatusYn": "Y",
  "evtFvrTypCd": 10,
  "sbscPsbMinOrdAmt": 1,
  "dataList": [
    {
      "evtFvrSeq": 1,
      "evtNo": 15322,
      "mbrNo": 1000000,
      "lotGb": "04",
      "trgmnSeq": 1,
      "loginId": "abde",
      "mbrNm": "김아무개",
      "mbrSexGb": "M",
      "mbrAge": 19,
      "cellNo": "01011112222"
    }
  ]
}

text

Event Drawing

post

Function Description

• Draws entrants of the event.

---

Detailed Description

• Event No. (evtNo) is required.

• Draws entrants of the event using the event number (evtNo) parameter.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

qryGbCdstringOptional

Excel Download Reason Code

indInfoQryCausstringOptional

Excel Download Reason

trgmnSeqstringOptional

Target Sequence No.

Example: 1

evtTrgmnGbCdstring · enumOptional

Event Target Classification Code (EV012)

Example: 04Possible values:

mbrNostringOptional

Member No.

Example: 100000

winRnkstringOptional

Winning Rank

Example: 1

winCnclCausContstringOptional

Winning Cancellation Reason Content

Example: 주문취소하여구매금액미달

evtNostringOptional

Event No.

Example: 15322

waitRnkstringOptional

Waitlist Rank

Example: 10

intxstringOptional

Income Tax

Example: 500000

citxstringOptional

Local Income Tax

Example: 30000

ordSumAmtstringOptional

Total Order Amount

Example: 50000

cfmOrdAmtstringOptional

Confirmed Order Amount

Example: 40000

evtSbscPathCdstring · enumOptional

Event Application Channel Code (OM007)

Example: 20Possible values:

tubaBankCdstring · enumOptional

Tax and Public Dues Bank Code (OM026)

Example: 104Possible values:

tubaDepositorNmstringOptional

Tax Withholding Account Holder Name

Example: 김아무개

tubaVirActnNostringOptional

Tax Withholding Virtual Account No.

Example: 11111-222-333-44

tubaDptAmtstringOptional

Tax Withholding Deposit Amount

Example: 50000

deliHdcCdstring · enumOptional

Delivery Courier Company Code (LO005)

Example: 10Possible values:

deliInvNostringOptional

Delivery Tracking No.

Example: 1141212314

mailSndCntstringOptional

Email Send Count

Example: 10

bbcNostringOptional

Post Number

Example: 114

lotCondSeqstringOptional

Drawing Condition Sequence No.

Example: 2

mbrNoListstring[]Optional

Member No. List

Example: [10000000,10000001,10000002]

mbrNmstringOptional

Member Name

Example: 홍길동

loginIdstringOptional

Member ID

Example: abc

cellNostringOptional

Mobile Phone Number

Example: 01011112222

cellSctNostringOptional

Mobile Phone Prefix Code

Example: 010

cellTxnoNostringOptional

Mobile Phone Exchange Code

Example: 1111

cellEndNostringOptional

Mobile Phone Last Digits

Example: 2222

lotObjCdstring · enumOptional

Drawing Purpose (EV022)

Example: 10Possible values:

lotExcpStafYnstringOptional

Exclude Employees from Drawing Target Status

Example: Y

trgmnSeqListstring[]Optional

Entry No.

Example: [100,101,102,103]

trgmnSeqArrstringOptional

Entry No.

Example: 100

lotTargetNuminteger · int32Optional

Number of Drawing Targets

Example: 100

lotLimitNuminteger · int32Optional

Number of Winners by Prize Benefit

Example: 50

evtMgrpCdstring · enumOptional

Event Type (EV002)

Example: 30Possible values:

buyAmtinteger · int32Optional

Purchase Amount

Example: 50000

setTypestringOptional

Win & Win Cancellation

Example: 10

lotTypestringOptional

Drawing Type: Draw:LL, Redraw:RL, Add to Waitlist:WA, Waitlist Draw:WL, Waitlist Win Cancellation:WC, Waitlist Redraw:WR

sndMethCdstring · enumOptional

Send Method Code (EV013)

Example: 01Possible values:

rcvmnNmstringOptional

Prize Recipient Name

Example: 김아무개

deliZipNostringOptional

Prize Delivery Address Postal Code

Example: 12345

deliZipAddrstringOptional

Prize Receiving Address

Example: 서울시 아무구 아무동 1번

deliZipDtlAddrstringOptional

Prize Receiving Address

Example: 아무건물 302호

deliTelNostringOptional

Prize Recipient Phone No.

Example: 021234567

deliTelRgnNostringOptional

Prize Recipient Phone Area Code

Example: 02

deliTelTxnoNostringOptional

Prize Recipient Phone Exchange No.

Example: 123

deliTelEndNostringOptional

Prize Recipient Phone Last Digits

Example: 4567

deliCellNostringOptional

Prize Recipient Mobile Phone No.

Example: 01011112222

deliCellSctNostringOptional

Prize Delivery Address Mobile Phone Prefix

Example: 010

deliCellTxnoNostringOptional

Prize Delivery Address Mobile Phone Middle Digits

Example: 1111

deliCellEndNostringOptional

Prize Delivery Address Mobile Phone Last Digits

Example: 2222

realGoodsstringOptional

Physical Prize

Example: 1002304

evtNmstringOptional

Event Name

Example: 이벤트

aempIdstringOptional

Event Manager

Example: 1002304

startDatestringOptional

Entry Period Start Date

endDatestringOptional

Entry Period End Date

excelHeaderstringOptional

Excel Header

winCnclDtmstring · date-timeOptional

Winning Cancellation Date/Time

winDtmstring · date-timeOptional

Winning Date/Time

myCertiDtmstring · date-timeOptional

Identity Verification Date/Time

sbscAplyDtmstring · date-timeOptional

Application Date/Time

wtpsSltDtmstring · date-timeOptional

Waitlist Selection Date/Time

tubaDptDtmstring · date-timeOptional

Tax Withholding Deposit Date/Time

buyStrDtmstring · date-timeOptional

Purchase Period Start Date/Time

buyEndDtmstring · date-timeOptional

Purchase Period End Date/Time

alarmStatusYnstringOptional

Notification Talk/Notification Usage Status

Example: Y

evtFvrTypCdstring · enumOptional

Event Benefit Type Code (EV011)

Example: 10Possible values:

sbscPsbMinOrdAmtnumberOptional

Minimum Order Payment Amount for Entry

Responses

200

Drawing Success

*/*

stringOptional

900

Drawing Failure

*/*

post/v1/marketing/eventMgmt/saveEvtTrgmnLotProc

POST /api/bo/v1/marketing/eventMgmt/saveEvtTrgmnLotProc HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1774

{
  "qryGbCd": "text",
  "indInfoQryCaus": "text",
  "trgmnSeq": 1,
  "evtTrgmnGbCd": "04",
  "mbrNo": 100000,
  "winRnk": 1,
  "winCnclCausCont": "주문취소하여구매금액미달",
  "evtNo": 15322,
  "waitRnk": 10,
  "intx": 500000,
  "citx": 30000,
  "ordSumAmt": 50000,
  "cfmOrdAmt": 40000,
  "evtSbscPathCd": 20,
  "tubaBankCd": 104,
  "tubaDepositorNm": "김아무개",
  "tubaVirActnNo": "11111-222-333-44",
  "tubaDptAmt": 50000,
  "deliHdcCd": 10,
  "deliInvNo": 1141212314,
  "mailSndCnt": 10,
  "bbcNo": 114,
  "lotCondSeq": 2,
  "mbrNoList": [
    10000000,
    10000001,
    10000002
  ],
  "mbrNm": "홍길동",
  "loginId": "abc",
  "cellNo": "01011112222",
  "cellSctNo": "010",
  "cellTxnoNo": 1111,
  "cellEndNo": 2222,
  "lotObjCd": 10,
  "lotExcpStafYn": "Y",
  "trgmnSeqList": [
    100,
    101,
    102,
    103
  ],
  "trgmnSeqArr": 100,
  "lotTargetNum": 100,
  "lotLimitNum": 50,
  "evtMgrpCd": 30,
  "buyAmt": 50000,
  "setType": 10,
  "lotType": "text",
  "sndMethCd": "01",
  "rcvmnNm": "김아무개",
  "deliZipNo": 12345,
  "deliZipAddr": "서울시 아무구 아무동 1번",
  "deliZipDtlAddr": "아무건물 302호",
  "deliTelNo": "021234567",
  "deliTelRgnNo": "02",
  "deliTelTxnoNo": 123,
  "deliTelEndNo": 4567,
  "deliCellNo": "01011112222",
  "deliCellSctNo": "010",
  "deliCellTxnoNo": 1111,
  "deliCellEndNo": 2222,
  "realGoods": 1002304,
  "evtNm": "이벤트",
  "aempId": 1002304,
  "startDate": "text",
  "endDate": "text",
  "excelHeader": "text",
  "winCnclDtm": "2026-01-01T00:00:00.000Z",
  "winDtm": "2026-01-01T00:00:00.000Z",
  "myCertiDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
  "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
  "tubaDptDtm": "2026-01-01T00:00:00.000Z",
  "buyStrDtm": "2026-01-01T00:00:00.000Z",
  "buyEndDtm": "2026-01-01T00:00:00.000Z",
  "alarmStatusYn": "Y",
  "evtFvrTypCd": 10,
  "sbscPsbMinOrdAmt": 1,
  "dataList": [
    {
      "evtFvrSeq": 1,
      "evtNo": 15322,
      "mbrNo": 1000000,
      "lotGb": "04",
      "trgmnSeq": 1,
      "loginId": "abde",
      "mbrNm": "김아무개",
      "mbrSexGb": "M",
      "mbrAge": 19,
      "cellNo": "01011112222"
    }
  ]
}

text

Save Event Waitlist Cancellation

post

Function Description

• Saves the waitlist cancellation for an event.

---

Detailed Description

• Event No. (evtNo), Applicant Sequence No. (trgmnSeq) are required.

• Saves the waitlist cancellation of an applicant for the event using the evtNo parameter.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

qryGbCdstringOptional

Excel Download Reason Code

indInfoQryCausstringOptional

Excel Download Reason

trgmnSeqstringOptional

Target Sequence No.

Example: 1

evtTrgmnGbCdstring · enumOptional

Event Target Classification Code (EV012)

Example: 04Possible values:

mbrNostringOptional

Member No.

Example: 100000

winRnkstringOptional

Winning Rank

Example: 1

winCnclCausContstringOptional

Winning Cancellation Reason Content

Example: 주문취소하여구매금액미달

evtNostringOptional

Event No.

Example: 15322

waitRnkstringOptional

Waitlist Rank

Example: 10

intxstringOptional

Income Tax

Example: 500000

citxstringOptional

Local Income Tax

Example: 30000

ordSumAmtstringOptional

Total Order Amount

Example: 50000

cfmOrdAmtstringOptional

Confirmed Order Amount

Example: 40000

evtSbscPathCdstring · enumOptional

Event Application Channel Code (OM007)

Example: 20Possible values:

tubaBankCdstring · enumOptional

Tax and Public Dues Bank Code (OM026)

Example: 104Possible values:

tubaDepositorNmstringOptional

Tax Withholding Account Holder Name

Example: 김아무개

tubaVirActnNostringOptional

Tax Withholding Virtual Account No.

Example: 11111-222-333-44

tubaDptAmtstringOptional

Tax Withholding Deposit Amount

Example: 50000

deliHdcCdstring · enumOptional

Delivery Courier Company Code (LO005)

Example: 10Possible values:

deliInvNostringOptional

Delivery Tracking No.

Example: 1141212314

mailSndCntstringOptional

Email Send Count

Example: 10

bbcNostringOptional

Post Number

Example: 114

lotCondSeqstringOptional

Drawing Condition Sequence No.

Example: 2

mbrNoListstring[]Optional

Member No. List

Example: [10000000,10000001,10000002]

mbrNmstringOptional

Member Name

Example: 홍길동

loginIdstringOptional

Member ID

Example: abc

cellNostringOptional

Mobile Phone Number

Example: 01011112222

cellSctNostringOptional

Mobile Phone Prefix Code

Example: 010

cellTxnoNostringOptional

Mobile Phone Exchange Code

Example: 1111

cellEndNostringOptional

Mobile Phone Last Digits

Example: 2222

lotObjCdstring · enumOptional

Drawing Purpose (EV022)

Example: 10Possible values:

lotExcpStafYnstringOptional

Exclude Employees from Drawing Target Status

Example: Y

trgmnSeqListstring[]Optional

Entry No.

Example: [100,101,102,103]

trgmnSeqArrstringOptional

Entry No.

Example: 100

lotTargetNuminteger · int32Optional

Number of Drawing Targets

Example: 100

lotLimitNuminteger · int32Optional

Number of Winners by Prize Benefit

Example: 50

evtMgrpCdstring · enumOptional

Event Type (EV002)

Example: 30Possible values:

buyAmtinteger · int32Optional

Purchase Amount

Example: 50000

setTypestringOptional

Win & Win Cancellation

Example: 10

lotTypestringOptional

Drawing Type: Draw:LL, Redraw:RL, Add to Waitlist:WA, Waitlist Draw:WL, Waitlist Win Cancellation:WC, Waitlist Redraw:WR

sndMethCdstring · enumOptional

Send Method Code (EV013)

Example: 01Possible values:

rcvmnNmstringOptional

Prize Recipient Name

Example: 김아무개

deliZipNostringOptional

Prize Delivery Address Postal Code

Example: 12345

deliZipAddrstringOptional

Prize Receiving Address

Example: 서울시 아무구 아무동 1번

deliZipDtlAddrstringOptional

Prize Receiving Address

Example: 아무건물 302호

deliTelNostringOptional

Prize Recipient Phone No.

Example: 021234567

deliTelRgnNostringOptional

Prize Recipient Phone Area Code

Example: 02

deliTelTxnoNostringOptional

Prize Recipient Phone Exchange No.

Example: 123

deliTelEndNostringOptional

Prize Recipient Phone Last Digits

Example: 4567

deliCellNostringOptional

Prize Recipient Mobile Phone No.

Example: 01011112222

deliCellSctNostringOptional

Prize Delivery Address Mobile Phone Prefix

Example: 010

deliCellTxnoNostringOptional

Prize Delivery Address Mobile Phone Middle Digits

Example: 1111

deliCellEndNostringOptional

Prize Delivery Address Mobile Phone Last Digits

Example: 2222

realGoodsstringOptional

Physical Prize

Example: 1002304

evtNmstringOptional

Event Name

Example: 이벤트

aempIdstringOptional

Event Manager

Example: 1002304

startDatestringOptional

Entry Period Start Date

endDatestringOptional

Entry Period End Date

excelHeaderstringOptional

Excel Header

winCnclDtmstring · date-timeOptional

Winning Cancellation Date/Time

winDtmstring · date-timeOptional

Winning Date/Time

myCertiDtmstring · date-timeOptional

Identity Verification Date/Time

sbscAplyDtmstring · date-timeOptional

Application Date/Time

wtpsSltDtmstring · date-timeOptional

Waitlist Selection Date/Time

tubaDptDtmstring · date-timeOptional

Tax Withholding Deposit Date/Time

buyStrDtmstring · date-timeOptional

Purchase Period Start Date/Time

buyEndDtmstring · date-timeOptional

Purchase Period End Date/Time

alarmStatusYnstringOptional

Notification Talk/Notification Usage Status

Example: Y

evtFvrTypCdstring · enumOptional

Event Benefit Type Code (EV011)

Example: 10Possible values:

sbscPsbMinOrdAmtnumberOptional

Minimum Order Payment Amount for Entry

Responses

200

Waitlist Cancellation Success

*/*

stringOptional

900

Waitlist Cancellation Failure

*/*

post/v1/marketing/eventMgmt/saveEventMgmtTrgmnWaitProc

POST /api/bo/v1/marketing/eventMgmt/saveEventMgmtTrgmnWaitProc HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1774

{
  "qryGbCd": "text",
  "indInfoQryCaus": "text",
  "trgmnSeq": 1,
  "evtTrgmnGbCd": "04",
  "mbrNo": 100000,
  "winRnk": 1,
  "winCnclCausCont": "주문취소하여구매금액미달",
  "evtNo": 15322,
  "waitRnk": 10,
  "intx": 500000,
  "citx": 30000,
  "ordSumAmt": 50000,
  "cfmOrdAmt": 40000,
  "evtSbscPathCd": 20,
  "tubaBankCd": 104,
  "tubaDepositorNm": "김아무개",
  "tubaVirActnNo": "11111-222-333-44",
  "tubaDptAmt": 50000,
  "deliHdcCd": 10,
  "deliInvNo": 1141212314,
  "mailSndCnt": 10,
  "bbcNo": 114,
  "lotCondSeq": 2,
  "mbrNoList": [
    10000000,
    10000001,
    10000002
  ],
  "mbrNm": "홍길동",
  "loginId": "abc",
  "cellNo": "01011112222",
  "cellSctNo": "010",
  "cellTxnoNo": 1111,
  "cellEndNo": 2222,
  "lotObjCd": 10,
  "lotExcpStafYn": "Y",
  "trgmnSeqList": [
    100,
    101,
    102,
    103
  ],
  "trgmnSeqArr": 100,
  "lotTargetNum": 100,
  "lotLimitNum": 50,
  "evtMgrpCd": 30,
  "buyAmt": 50000,
  "setType": 10,
  "lotType": "text",
  "sndMethCd": "01",
  "rcvmnNm": "김아무개",
  "deliZipNo": 12345,
  "deliZipAddr": "서울시 아무구 아무동 1번",
  "deliZipDtlAddr": "아무건물 302호",
  "deliTelNo": "021234567",
  "deliTelRgnNo": "02",
  "deliTelTxnoNo": 123,
  "deliTelEndNo": 4567,
  "deliCellNo": "01011112222",
  "deliCellSctNo": "010",
  "deliCellTxnoNo": 1111,
  "deliCellEndNo": 2222,
  "realGoods": 1002304,
  "evtNm": "이벤트",
  "aempId": 1002304,
  "startDate": "text",
  "endDate": "text",
  "excelHeader": "text",
  "winCnclDtm": "2026-01-01T00:00:00.000Z",
  "winDtm": "2026-01-01T00:00:00.000Z",
  "myCertiDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
  "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
  "tubaDptDtm": "2026-01-01T00:00:00.000Z",
  "buyStrDtm": "2026-01-01T00:00:00.000Z",
  "buyEndDtm": "2026-01-01T00:00:00.000Z",
  "alarmStatusYn": "Y",
  "evtFvrTypCd": 10,
  "sbscPsbMinOrdAmt": 1,
  "dataList": [
    {
      "evtFvrSeq": 1,
      "evtNo": 15322,
      "mbrNo": 1000000,
      "lotGb": "04",
      "trgmnSeq": 1,
      "loginId": "abde",
      "mbrNm": "김아무개",
      "mbrSexGb": "M",
      "mbrAge": 19,
      "cellNo": "01011112222"
    }
  ]
}

text

Save Event Entry Management Grid

post

Function Description

• Saves the Event Entry Management grid.

---

Detailed Description

• Applicant-related data (applicant number, event number, etc.) are required.

• Saves the applicant-related grid information.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

Responses

200

Grid Saved Successfully

*/*

stringOptional

900

Grid Save Failed

*/*

post/v1/marketing/eventMgmt/saveEventMgmtTrgmnInfo

POST /api/bo/v1/marketing/eventMgmt/saveEventMgmtTrgmnInfo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 7142

{
  "all": [
    {
      "qryGbCd": "text",
      "indInfoQryCaus": "text",
      "trgmnSeq": 1,
      "evtTrgmnGbCd": "04",
      "mbrNo": 100000,
      "winRnk": 1,
      "winCnclCausCont": "주문취소하여구매금액미달",
      "evtNo": 15322,
      "waitRnk": 10,
      "intx": 500000,
      "citx": 30000,
      "ordSumAmt": 50000,
      "cfmOrdAmt": 40000,
      "evtSbscPathCd": 20,
      "tubaBankCd": 104,
      "tubaDepositorNm": "김아무개",
      "tubaVirActnNo": "11111-222-333-44",
      "tubaDptAmt": 50000,
      "deliHdcCd": 10,
      "deliInvNo": 1141212314,
      "mailSndCnt": 10,
      "bbcNo": 114,
      "lotCondSeq": 2,
      "mbrNoList": [
        10000000,
        10000001,
        10000002
      ],
      "mbrNm": "홍길동",
      "loginId": "abc",
      "cellNo": "01011112222",
      "cellSctNo": "010",
      "cellTxnoNo": 1111,
      "cellEndNo": 2222,
      "lotObjCd": 10,
      "lotExcpStafYn": "Y",
      "trgmnSeqList": [
        100,
        101,
        102,
        103
      ],
      "trgmnSeqArr": 100,
      "lotTargetNum": 100,
      "lotLimitNum": 50,
      "evtMgrpCd": 30,
      "buyAmt": 50000,
      "setType": 10,
      "lotType": "text",
      "sndMethCd": "01",
      "rcvmnNm": "김아무개",
      "deliZipNo": 12345,
      "deliZipAddr": "서울시 아무구 아무동 1번",
      "deliZipDtlAddr": "아무건물 302호",
      "deliTelNo": "021234567",
      "deliTelRgnNo": "02",
      "deliTelTxnoNo": 123,
      "deliTelEndNo": 4567,
      "deliCellNo": "01011112222",
      "deliCellSctNo": "010",
      "deliCellTxnoNo": 1111,
      "deliCellEndNo": 2222,
      "realGoods": 1002304,
      "evtNm": "이벤트",
      "aempId": 1002304,
      "startDate": "text",
      "endDate": "text",
      "excelHeader": "text",
      "winCnclDtm": "2026-01-01T00:00:00.000Z",
      "winDtm": "2026-01-01T00:00:00.000Z",
      "myCertiDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
      "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "alarmStatusYn": "Y",
      "evtFvrTypCd": 10,
      "sbscPsbMinOrdAmt": 1,
      "dataList": [
        {
          "evtFvrSeq": 1,
          "evtNo": 15322,
          "mbrNo": 1000000,
          "lotGb": "04",
          "trgmnSeq": 1,
          "loginId": "abde",
          "mbrNm": "김아무개",
          "mbrSexGb": "M",
          "mbrAge": 19,
          "cellNo": "01011112222"
        }
      ]
    }
  ],
  "create": [
    {
      "qryGbCd": "text",
      "indInfoQryCaus": "text",
      "trgmnSeq": 1,
      "evtTrgmnGbCd": "04",
      "mbrNo": 100000,
      "winRnk": 1,
      "winCnclCausCont": "주문취소하여구매금액미달",
      "evtNo": 15322,
      "waitRnk": 10,
      "intx": 500000,
      "citx": 30000,
      "ordSumAmt": 50000,
      "cfmOrdAmt": 40000,
      "evtSbscPathCd": 20,
      "tubaBankCd": 104,
      "tubaDepositorNm": "김아무개",
      "tubaVirActnNo": "11111-222-333-44",
      "tubaDptAmt": 50000,
      "deliHdcCd": 10,
      "deliInvNo": 1141212314,
      "mailSndCnt": 10,
      "bbcNo": 114,
      "lotCondSeq": 2,
      "mbrNoList": [
        10000000,
        10000001,
        10000002
      ],
      "mbrNm": "홍길동",
      "loginId": "abc",
      "cellNo": "01011112222",
      "cellSctNo": "010",
      "cellTxnoNo": 1111,
      "cellEndNo": 2222,
      "lotObjCd": 10,
      "lotExcpStafYn": "Y",
      "trgmnSeqList": [
        100,
        101,
        102,
        103
      ],
      "trgmnSeqArr": 100,
      "lotTargetNum": 100,
      "lotLimitNum": 50,
      "evtMgrpCd": 30,
      "buyAmt": 50000,
      "setType": 10,
      "lotType": "text",
      "sndMethCd": "01",
      "rcvmnNm": "김아무개",
      "deliZipNo": 12345,
      "deliZipAddr": "서울시 아무구 아무동 1번",
      "deliZipDtlAddr": "아무건물 302호",
      "deliTelNo": "021234567",
      "deliTelRgnNo": "02",
      "deliTelTxnoNo": 123,
      "deliTelEndNo": 4567,
      "deliCellNo": "01011112222",
      "deliCellSctNo": "010",
      "deliCellTxnoNo": 1111,
      "deliCellEndNo": 2222,
      "realGoods": 1002304,
      "evtNm": "이벤트",
      "aempId": 1002304,
      "startDate": "text",
      "endDate": "text",
      "excelHeader": "text",
      "winCnclDtm": "2026-01-01T00:00:00.000Z",
      "winDtm": "2026-01-01T00:00:00.000Z",
      "myCertiDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
      "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "alarmStatusYn": "Y",
      "evtFvrTypCd": 10,
      "sbscPsbMinOrdAmt": 1,
      "dataList": [
        {
          "evtFvrSeq": 1,
          "evtNo": 15322,
          "mbrNo": 1000000,
          "lotGb": "04",
          "trgmnSeq": 1,
          "loginId": "abde",
          "mbrNm": "김아무개",
          "mbrSexGb": "M",
          "mbrAge": 19,
          "cellNo": "01011112222"
        }
      ]
    }
  ],
  "update": [
    {
      "qryGbCd": "text",
      "indInfoQryCaus": "text",
      "trgmnSeq": 1,
      "evtTrgmnGbCd": "04",
      "mbrNo": 100000,
      "winRnk": 1,
      "winCnclCausCont": "주문취소하여구매금액미달",
      "evtNo": 15322,
      "waitRnk": 10,
      "intx": 500000,
      "citx": 30000,
      "ordSumAmt": 50000,
      "cfmOrdAmt": 40000,
      "evtSbscPathCd": 20,
      "tubaBankCd": 104,
      "tubaDepositorNm": "김아무개",
      "tubaVirActnNo": "11111-222-333-44",
      "tubaDptAmt": 50000,
      "deliHdcCd": 10,
      "deliInvNo": 1141212314,
      "mailSndCnt": 10,
      "bbcNo": 114,
      "lotCondSeq": 2,
      "mbrNoList": [
        10000000,
        10000001,
        10000002
      ],
      "mbrNm": "홍길동",
      "loginId": "abc",
      "cellNo": "01011112222",
      "cellSctNo": "010",
      "cellTxnoNo": 1111,
      "cellEndNo": 2222,
      "lotObjCd": 10,
      "lotExcpStafYn": "Y",
      "trgmnSeqList": [
        100,
        101,
        102,
        103
      ],
      "trgmnSeqArr": 100,
      "lotTargetNum": 100,
      "lotLimitNum": 50,
      "evtMgrpCd": 30,
      "buyAmt": 50000,
      "setType": 10,
      "lotType": "text",
      "sndMethCd": "01",
      "rcvmnNm": "김아무개",
      "deliZipNo": 12345,
      "deliZipAddr": "서울시 아무구 아무동 1번",
      "deliZipDtlAddr": "아무건물 302호",
      "deliTelNo": "021234567",
      "deliTelRgnNo": "02",
      "deliTelTxnoNo": 123,
      "deliTelEndNo": 4567,
      "deliCellNo": "01011112222",
      "deliCellSctNo": "010",
      "deliCellTxnoNo": 1111,
      "deliCellEndNo": 2222,
      "realGoods": 1002304,
      "evtNm": "이벤트",
      "aempId": 1002304,
      "startDate": "text",
      "endDate": "text",
      "excelHeader": "text",
      "winCnclDtm": "2026-01-01T00:00:00.000Z",
      "winDtm": "2026-01-01T00:00:00.000Z",
      "myCertiDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
      "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "alarmStatusYn": "Y",
      "evtFvrTypCd": 10,
      "sbscPsbMinOrdAmt": 1,
      "dataList": [
        {
          "evtFvrSeq": 1,
          "evtNo": 15322,
          "mbrNo": 1000000,
          "lotGb": "04",
          "trgmnSeq": 1,
          "loginId": "abde",
          "mbrNm": "김아무개",
          "mbrSexGb": "M",
          "mbrAge": 19,
          "cellNo": "01011112222"
        }
      ]
    }
  ],
  "delete": [
    {
      "qryGbCd": "text",
      "indInfoQryCaus": "text",
      "trgmnSeq": 1,
      "evtTrgmnGbCd": "04",
      "mbrNo": 100000,
      "winRnk": 1,
      "winCnclCausCont": "주문취소하여구매금액미달",
      "evtNo": 15322,
      "waitRnk": 10,
      "intx": 500000,
      "citx": 30000,
      "ordSumAmt": 50000,
      "cfmOrdAmt": 40000,
      "evtSbscPathCd": 20,
      "tubaBankCd": 104,
      "tubaDepositorNm": "김아무개",
      "tubaVirActnNo": "11111-222-333-44",
      "tubaDptAmt": 50000,
      "deliHdcCd": 10,
      "deliInvNo": 1141212314,
      "mailSndCnt": 10,
      "bbcNo": 114,
      "lotCondSeq": 2,
      "mbrNoList": [
        10000000,
        10000001,
        10000002
      ],
      "mbrNm": "홍길동",
      "loginId": "abc",
      "cellNo": "01011112222",
      "cellSctNo": "010",
      "cellTxnoNo": 1111,
      "cellEndNo": 2222,
      "lotObjCd": 10,
      "lotExcpStafYn": "Y",
      "trgmnSeqList": [
        100,
        101,
        102,
        103
      ],
      "trgmnSeqArr": 100,
      "lotTargetNum": 100,
      "lotLimitNum": 50,
      "evtMgrpCd": 30,
      "buyAmt": 50000,
      "setType": 10,
      "lotType": "text",
      "sndMethCd": "01",
      "rcvmnNm": "김아무개",
      "deliZipNo": 12345,
      "deliZipAddr": "서울시 아무구 아무동 1번",
      "deliZipDtlAddr": "아무건물 302호",
      "deliTelNo": "021234567",
      "deliTelRgnNo": "02",
      "deliTelTxnoNo": 123,
      "deliTelEndNo": 4567,
      "deliCellNo": "01011112222",
      "deliCellSctNo": "010",
      "deliCellTxnoNo": 1111,
      "deliCellEndNo": 2222,
      "realGoods": 1002304,
      "evtNm": "이벤트",
      "aempId": 1002304,
      "startDate": "text",
      "endDate": "text",
      "excelHeader": "text",
      "winCnclDtm": "2026-01-01T00:00:00.000Z",
      "winDtm": "2026-01-01T00:00:00.000Z",
      "myCertiDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
      "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "alarmStatusYn": "Y",
      "evtFvrTypCd": 10,
      "sbscPsbMinOrdAmt": 1,
      "dataList": [
        {
          "evtFvrSeq": 1,
          "evtNo": 15322,
          "mbrNo": 1000000,
          "lotGb": "04",
          "trgmnSeq": 1,
          "loginId": "abde",
          "mbrNm": "김아무개",
          "mbrSexGb": "M",
          "mbrAge": 19,
          "cellNo": "01011112222"
        }
      ]
    }
  ]
}

text

Event Winner Prize Payment Request

post

Function Description

• Requests prize payment for event winners

---

Detailed Description

• Event No. (evtNo) is required.

• Marks the winner as payment completed.

• Registers/updates the delivery address information to deliver the prize to the member.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

qryGbCdstringOptional

Excel Download Reason Code

indInfoQryCausstringOptional

Excel Download Reason

trgmnSeqstringOptional

Target Sequence No.

Example: 1

evtTrgmnGbCdstring · enumOptional

Event Target Classification Code (EV012)

Example: 04Possible values:

mbrNostringOptional

Member No.

Example: 100000

winRnkstringOptional

Winning Rank

Example: 1

winCnclCausContstringOptional

Winning Cancellation Reason Content

Example: 주문취소하여구매금액미달

evtNostringOptional

Event No.

Example: 15322

waitRnkstringOptional

Waitlist Rank

Example: 10

intxstringOptional

Income Tax

Example: 500000

citxstringOptional

Local Income Tax

Example: 30000

ordSumAmtstringOptional

Total Order Amount

Example: 50000

cfmOrdAmtstringOptional

Confirmed Order Amount

Example: 40000

evtSbscPathCdstring · enumOptional

Event Application Channel Code (OM007)

Example: 20Possible values:

tubaBankCdstring · enumOptional

Tax and Public Dues Bank Code (OM026)

Example: 104Possible values:

tubaDepositorNmstringOptional

Tax Withholding Account Holder Name

Example: 김아무개

tubaVirActnNostringOptional

Tax Withholding Virtual Account No.

Example: 11111-222-333-44

tubaDptAmtstringOptional

Tax Withholding Deposit Amount

Example: 50000

deliHdcCdstring · enumOptional

Delivery Courier Company Code (LO005)

Example: 10Possible values:

deliInvNostringOptional

Delivery Tracking No.

Example: 1141212314

mailSndCntstringOptional

Email Send Count

Example: 10

bbcNostringOptional

Post Number

Example: 114

lotCondSeqstringOptional

Drawing Condition Sequence No.

Example: 2

mbrNoListstring[]Optional

Member No. List

Example: [10000000,10000001,10000002]

mbrNmstringOptional

Member Name

Example: 홍길동

loginIdstringOptional

Member ID

Example: abc

cellNostringOptional

Mobile Phone Number

Example: 01011112222

cellSctNostringOptional

Mobile Phone Prefix Code

Example: 010

cellTxnoNostringOptional

Mobile Phone Exchange Code

Example: 1111

cellEndNostringOptional

Mobile Phone Last Digits

Example: 2222

lotObjCdstring · enumOptional

Drawing Purpose (EV022)

Example: 10Possible values:

lotExcpStafYnstringOptional

Exclude Employees from Drawing Target Status

Example: Y

trgmnSeqListstring[]Optional

Entry No.

Example: [100,101,102,103]

trgmnSeqArrstringOptional

Entry No.

Example: 100

lotTargetNuminteger · int32Optional

Number of Drawing Targets

Example: 100

lotLimitNuminteger · int32Optional

Number of Winners by Prize Benefit

Example: 50

evtMgrpCdstring · enumOptional

Event Type (EV002)

Example: 30Possible values:

buyAmtinteger · int32Optional

Purchase Amount

Example: 50000

setTypestringOptional

Win & Win Cancellation

Example: 10

lotTypestringOptional

Drawing Type: Draw:LL, Redraw:RL, Add to Waitlist:WA, Waitlist Draw:WL, Waitlist Win Cancellation:WC, Waitlist Redraw:WR

sndMethCdstring · enumOptional

Send Method Code (EV013)

Example: 01Possible values:

rcvmnNmstringOptional

Prize Recipient Name

Example: 김아무개

deliZipNostringOptional

Prize Delivery Address Postal Code

Example: 12345

deliZipAddrstringOptional

Prize Receiving Address

Example: 서울시 아무구 아무동 1번

deliZipDtlAddrstringOptional

Prize Receiving Address

Example: 아무건물 302호

deliTelNostringOptional

Prize Recipient Phone No.

Example: 021234567

deliTelRgnNostringOptional

Prize Recipient Phone Area Code

Example: 02

deliTelTxnoNostringOptional

Prize Recipient Phone Exchange No.

Example: 123

deliTelEndNostringOptional

Prize Recipient Phone Last Digits

Example: 4567

deliCellNostringOptional

Prize Recipient Mobile Phone No.

Example: 01011112222

deliCellSctNostringOptional

Prize Delivery Address Mobile Phone Prefix

Example: 010

deliCellTxnoNostringOptional

Prize Delivery Address Mobile Phone Middle Digits

Example: 1111

deliCellEndNostringOptional

Prize Delivery Address Mobile Phone Last Digits

Example: 2222

realGoodsstringOptional

Physical Prize

Example: 1002304

evtNmstringOptional

Event Name

Example: 이벤트

aempIdstringOptional

Event Manager

Example: 1002304

startDatestringOptional

Entry Period Start Date

endDatestringOptional

Entry Period End Date

excelHeaderstringOptional

Excel Header

winCnclDtmstring · date-timeOptional

Winning Cancellation Date/Time

winDtmstring · date-timeOptional

Winning Date/Time

myCertiDtmstring · date-timeOptional

Identity Verification Date/Time

sbscAplyDtmstring · date-timeOptional

Application Date/Time

wtpsSltDtmstring · date-timeOptional

Waitlist Selection Date/Time

tubaDptDtmstring · date-timeOptional

Tax Withholding Deposit Date/Time

buyStrDtmstring · date-timeOptional

Purchase Period Start Date/Time

buyEndDtmstring · date-timeOptional

Purchase Period End Date/Time

alarmStatusYnstringOptional

Notification Talk/Notification Usage Status

Example: Y

evtFvrTypCdstring · enumOptional

Event Benefit Type Code (EV011)

Example: 10Possible values:

sbscPsbMinOrdAmtnumberOptional

Minimum Order Payment Amount for Entry

Responses

200

Prize Payment Request Succeeded

*/*

stringOptional

900

Prize Payment Request Failed

*/*

post/v1/marketing/eventMgmt/saveEventMgmtPmgdPaymentRequest

POST /api/bo/v1/marketing/eventMgmt/saveEventMgmtPmgdPaymentRequest HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1774

{
  "qryGbCd": "text",
  "indInfoQryCaus": "text",
  "trgmnSeq": 1,
  "evtTrgmnGbCd": "04",
  "mbrNo": 100000,
  "winRnk": 1,
  "winCnclCausCont": "주문취소하여구매금액미달",
  "evtNo": 15322,
  "waitRnk": 10,
  "intx": 500000,
  "citx": 30000,
  "ordSumAmt": 50000,
  "cfmOrdAmt": 40000,
  "evtSbscPathCd": 20,
  "tubaBankCd": 104,
  "tubaDepositorNm": "김아무개",
  "tubaVirActnNo": "11111-222-333-44",
  "tubaDptAmt": 50000,
  "deliHdcCd": 10,
  "deliInvNo": 1141212314,
  "mailSndCnt": 10,
  "bbcNo": 114,
  "lotCondSeq": 2,
  "mbrNoList": [
    10000000,
    10000001,
    10000002
  ],
  "mbrNm": "홍길동",
  "loginId": "abc",
  "cellNo": "01011112222",
  "cellSctNo": "010",
  "cellTxnoNo": 1111,
  "cellEndNo": 2222,
  "lotObjCd": 10,
  "lotExcpStafYn": "Y",
  "trgmnSeqList": [
    100,
    101,
    102,
    103
  ],
  "trgmnSeqArr": 100,
  "lotTargetNum": 100,
  "lotLimitNum": 50,
  "evtMgrpCd": 30,
  "buyAmt": 50000,
  "setType": 10,
  "lotType": "text",
  "sndMethCd": "01",
  "rcvmnNm": "김아무개",
  "deliZipNo": 12345,
  "deliZipAddr": "서울시 아무구 아무동 1번",
  "deliZipDtlAddr": "아무건물 302호",
  "deliTelNo": "021234567",
  "deliTelRgnNo": "02",
  "deliTelTxnoNo": 123,
  "deliTelEndNo": 4567,
  "deliCellNo": "01011112222",
  "deliCellSctNo": "010",
  "deliCellTxnoNo": 1111,
  "deliCellEndNo": 2222,
  "realGoods": 1002304,
  "evtNm": "이벤트",
  "aempId": 1002304,
  "startDate": "text",
  "endDate": "text",
  "excelHeader": "text",
  "winCnclDtm": "2026-01-01T00:00:00.000Z",
  "winDtm": "2026-01-01T00:00:00.000Z",
  "myCertiDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
  "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
  "tubaDptDtm": "2026-01-01T00:00:00.000Z",
  "buyStrDtm": "2026-01-01T00:00:00.000Z",
  "buyEndDtm": "2026-01-01T00:00:00.000Z",
  "alarmStatusYn": "Y",
  "evtFvrTypCd": 10,
  "sbscPsbMinOrdAmt": 1,
  "dataList": [
    {
      "evtFvrSeq": 1,
      "evtNo": 15322,
      "mbrNo": 1000000,
      "lotGb": "04",
      "trgmnSeq": 1,
      "loginId": "abde",
      "mbrNm": "김아무개",
      "mbrSexGb": "M",
      "mbrAge": 19,
      "cellNo": "01011112222"
    }
  ]
}

text

Save Invoice Number for Event Payment Management

post

Function Description

• Saves the invoice number for Event Payment Management.

---

Detailed Description

• Event No. (evtNo), Applicant Sequence No. (trgmnSeq), Courier Company Code (LO005) (deliHdcCd), Delivery Invoice No. (deliInvNo) are required.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

Responses

200

Invoice Number Save Success

*/*

stringOptional

900

Invoice Number Save Failure

*/*

post/v1/marketing/eventMgmt/saveEventMgmtPayMgmtTrgmnInfo

POST /api/bo/v1/marketing/eventMgmt/saveEventMgmtPayMgmtTrgmnInfo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 7142

{
  "all": [
    {
      "qryGbCd": "text",
      "indInfoQryCaus": "text",
      "trgmnSeq": 1,
      "evtTrgmnGbCd": "04",
      "mbrNo": 100000,
      "winRnk": 1,
      "winCnclCausCont": "주문취소하여구매금액미달",
      "evtNo": 15322,
      "waitRnk": 10,
      "intx": 500000,
      "citx": 30000,
      "ordSumAmt": 50000,
      "cfmOrdAmt": 40000,
      "evtSbscPathCd": 20,
      "tubaBankCd": 104,
      "tubaDepositorNm": "김아무개",
      "tubaVirActnNo": "11111-222-333-44",
      "tubaDptAmt": 50000,
      "deliHdcCd": 10,
      "deliInvNo": 1141212314,
      "mailSndCnt": 10,
      "bbcNo": 114,
      "lotCondSeq": 2,
      "mbrNoList": [
        10000000,
        10000001,
        10000002
      ],
      "mbrNm": "홍길동",
      "loginId": "abc",
      "cellNo": "01011112222",
      "cellSctNo": "010",
      "cellTxnoNo": 1111,
      "cellEndNo": 2222,
      "lotObjCd": 10,
      "lotExcpStafYn": "Y",
      "trgmnSeqList": [
        100,
        101,
        102,
        103
      ],
      "trgmnSeqArr": 100,
      "lotTargetNum": 100,
      "lotLimitNum": 50,
      "evtMgrpCd": 30,
      "buyAmt": 50000,
      "setType": 10,
      "lotType": "text",
      "sndMethCd": "01",
      "rcvmnNm": "김아무개",
      "deliZipNo": 12345,
      "deliZipAddr": "서울시 아무구 아무동 1번",
      "deliZipDtlAddr": "아무건물 302호",
      "deliTelNo": "021234567",
      "deliTelRgnNo": "02",
      "deliTelTxnoNo": 123,
      "deliTelEndNo": 4567,
      "deliCellNo": "01011112222",
      "deliCellSctNo": "010",
      "deliCellTxnoNo": 1111,
      "deliCellEndNo": 2222,
      "realGoods": 1002304,
      "evtNm": "이벤트",
      "aempId": 1002304,
      "startDate": "text",
      "endDate": "text",
      "excelHeader": "text",
      "winCnclDtm": "2026-01-01T00:00:00.000Z",
      "winDtm": "2026-01-01T00:00:00.000Z",
      "myCertiDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
      "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "alarmStatusYn": "Y",
      "evtFvrTypCd": 10,
      "sbscPsbMinOrdAmt": 1,
      "dataList": [
        {
          "evtFvrSeq": 1,
          "evtNo": 15322,
          "mbrNo": 1000000,
          "lotGb": "04",
          "trgmnSeq": 1,
          "loginId": "abde",
          "mbrNm": "김아무개",
          "mbrSexGb": "M",
          "mbrAge": 19,
          "cellNo": "01011112222"
        }
      ]
    }
  ],
  "create": [
    {
      "qryGbCd": "text",
      "indInfoQryCaus": "text",
      "trgmnSeq": 1,
      "evtTrgmnGbCd": "04",
      "mbrNo": 100000,
      "winRnk": 1,
      "winCnclCausCont": "주문취소하여구매금액미달",
      "evtNo": 15322,
      "waitRnk": 10,
      "intx": 500000,
      "citx": 30000,
      "ordSumAmt": 50000,
      "cfmOrdAmt": 40000,
      "evtSbscPathCd": 20,
      "tubaBankCd": 104,
      "tubaDepositorNm": "김아무개",
      "tubaVirActnNo": "11111-222-333-44",
      "tubaDptAmt": 50000,
      "deliHdcCd": 10,
      "deliInvNo": 1141212314,
      "mailSndCnt": 10,
      "bbcNo": 114,
      "lotCondSeq": 2,
      "mbrNoList": [
        10000000,
        10000001,
        10000002
      ],
      "mbrNm": "홍길동",
      "loginId": "abc",
      "cellNo": "01011112222",
      "cellSctNo": "010",
      "cellTxnoNo": 1111,
      "cellEndNo": 2222,
      "lotObjCd": 10,
      "lotExcpStafYn": "Y",
      "trgmnSeqList": [
        100,
        101,
        102,
        103
      ],
      "trgmnSeqArr": 100,
      "lotTargetNum": 100,
      "lotLimitNum": 50,
      "evtMgrpCd": 30,
      "buyAmt": 50000,
      "setType": 10,
      "lotType": "text",
      "sndMethCd": "01",
      "rcvmnNm": "김아무개",
      "deliZipNo": 12345,
      "deliZipAddr": "서울시 아무구 아무동 1번",
      "deliZipDtlAddr": "아무건물 302호",
      "deliTelNo": "021234567",
      "deliTelRgnNo": "02",
      "deliTelTxnoNo": 123,
      "deliTelEndNo": 4567,
      "deliCellNo": "01011112222",
      "deliCellSctNo": "010",
      "deliCellTxnoNo": 1111,
      "deliCellEndNo": 2222,
      "realGoods": 1002304,
      "evtNm": "이벤트",
      "aempId": 1002304,
      "startDate": "text",
      "endDate": "text",
      "excelHeader": "text",
      "winCnclDtm": "2026-01-01T00:00:00.000Z",
      "winDtm": "2026-01-01T00:00:00.000Z",
      "myCertiDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
      "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "alarmStatusYn": "Y",
      "evtFvrTypCd": 10,
      "sbscPsbMinOrdAmt": 1,
      "dataList": [
        {
          "evtFvrSeq": 1,
          "evtNo": 15322,
          "mbrNo": 1000000,
          "lotGb": "04",
          "trgmnSeq": 1,
          "loginId": "abde",
          "mbrNm": "김아무개",
          "mbrSexGb": "M",
          "mbrAge": 19,
          "cellNo": "01011112222"
        }
      ]
    }
  ],
  "update": [
    {
      "qryGbCd": "text",
      "indInfoQryCaus": "text",
      "trgmnSeq": 1,
      "evtTrgmnGbCd": "04",
      "mbrNo": 100000,
      "winRnk": 1,
      "winCnclCausCont": "주문취소하여구매금액미달",
      "evtNo": 15322,
      "waitRnk": 10,
      "intx": 500000,
      "citx": 30000,
      "ordSumAmt": 50000,
      "cfmOrdAmt": 40000,
      "evtSbscPathCd": 20,
      "tubaBankCd": 104,
      "tubaDepositorNm": "김아무개",
      "tubaVirActnNo": "11111-222-333-44",
      "tubaDptAmt": 50000,
      "deliHdcCd": 10,
      "deliInvNo": 1141212314,
      "mailSndCnt": 10,
      "bbcNo": 114,
      "lotCondSeq": 2,
      "mbrNoList": [
        10000000,
        10000001,
        10000002
      ],
      "mbrNm": "홍길동",
      "loginId": "abc",
      "cellNo": "01011112222",
      "cellSctNo": "010",
      "cellTxnoNo": 1111,
      "cellEndNo": 2222,
      "lotObjCd": 10,
      "lotExcpStafYn": "Y",
      "trgmnSeqList": [
        100,
        101,
        102,
        103
      ],
      "trgmnSeqArr": 100,
      "lotTargetNum": 100,
      "lotLimitNum": 50,
      "evtMgrpCd": 30,
      "buyAmt": 50000,
      "setType": 10,
      "lotType": "text",
      "sndMethCd": "01",
      "rcvmnNm": "김아무개",
      "deliZipNo": 12345,
      "deliZipAddr": "서울시 아무구 아무동 1번",
      "deliZipDtlAddr": "아무건물 302호",
      "deliTelNo": "021234567",
      "deliTelRgnNo": "02",
      "deliTelTxnoNo": 123,
      "deliTelEndNo": 4567,
      "deliCellNo": "01011112222",
      "deliCellSctNo": "010",
      "deliCellTxnoNo": 1111,
      "deliCellEndNo": 2222,
      "realGoods": 1002304,
      "evtNm": "이벤트",
      "aempId": 1002304,
      "startDate": "text",
      "endDate": "text",
      "excelHeader": "text",
      "winCnclDtm": "2026-01-01T00:00:00.000Z",
      "winDtm": "2026-01-01T00:00:00.000Z",
      "myCertiDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
      "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "alarmStatusYn": "Y",
      "evtFvrTypCd": 10,
      "sbscPsbMinOrdAmt": 1,
      "dataList": [
        {
          "evtFvrSeq": 1,
          "evtNo": 15322,
          "mbrNo": 1000000,
          "lotGb": "04",
          "trgmnSeq": 1,
          "loginId": "abde",
          "mbrNm": "김아무개",
          "mbrSexGb": "M",
          "mbrAge": 19,
          "cellNo": "01011112222"
        }
      ]
    }
  ],
  "delete": [
    {
      "qryGbCd": "text",
      "indInfoQryCaus": "text",
      "trgmnSeq": 1,
      "evtTrgmnGbCd": "04",
      "mbrNo": 100000,
      "winRnk": 1,
      "winCnclCausCont": "주문취소하여구매금액미달",
      "evtNo": 15322,
      "waitRnk": 10,
      "intx": 500000,
      "citx": 30000,
      "ordSumAmt": 50000,
      "cfmOrdAmt": 40000,
      "evtSbscPathCd": 20,
      "tubaBankCd": 104,
      "tubaDepositorNm": "김아무개",
      "tubaVirActnNo": "11111-222-333-44",
      "tubaDptAmt": 50000,
      "deliHdcCd": 10,
      "deliInvNo": 1141212314,
      "mailSndCnt": 10,
      "bbcNo": 114,
      "lotCondSeq": 2,
      "mbrNoList": [
        10000000,
        10000001,
        10000002
      ],
      "mbrNm": "홍길동",
      "loginId": "abc",
      "cellNo": "01011112222",
      "cellSctNo": "010",
      "cellTxnoNo": 1111,
      "cellEndNo": 2222,
      "lotObjCd": 10,
      "lotExcpStafYn": "Y",
      "trgmnSeqList": [
        100,
        101,
        102,
        103
      ],
      "trgmnSeqArr": 100,
      "lotTargetNum": 100,
      "lotLimitNum": 50,
      "evtMgrpCd": 30,
      "buyAmt": 50000,
      "setType": 10,
      "lotType": "text",
      "sndMethCd": "01",
      "rcvmnNm": "김아무개",
      "deliZipNo": 12345,
      "deliZipAddr": "서울시 아무구 아무동 1번",
      "deliZipDtlAddr": "아무건물 302호",
      "deliTelNo": "021234567",
      "deliTelRgnNo": "02",
      "deliTelTxnoNo": 123,
      "deliTelEndNo": 4567,
      "deliCellNo": "01011112222",
      "deliCellSctNo": "010",
      "deliCellTxnoNo": 1111,
      "deliCellEndNo": 2222,
      "realGoods": 1002304,
      "evtNm": "이벤트",
      "aempId": 1002304,
      "startDate": "text",
      "endDate": "text",
      "excelHeader": "text",
      "winCnclDtm": "2026-01-01T00:00:00.000Z",
      "winDtm": "2026-01-01T00:00:00.000Z",
      "myCertiDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
      "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "alarmStatusYn": "Y",
      "evtFvrTypCd": 10,
      "sbscPsbMinOrdAmt": 1,
      "dataList": [
        {
          "evtFvrSeq": 1,
          "evtNo": 15322,
          "mbrNo": 1000000,
          "lotGb": "04",
          "trgmnSeq": 1,
          "loginId": "abde",
          "mbrNm": "김아무개",
          "mbrSexGb": "M",
          "mbrAge": 19,
          "cellNo": "01011112222"
        }
      ]
    }
  ]
}

text

Event Winner Mileage Payment Request

post

Function Description

• Requests mileage payment for event winners

---

Detailed Description

• Event No. (evtNo) is required.

• Pays mileage to the winner.

• Marks the winner as payment completed.

• Sends a notification talk/notification to the winner.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

qryGbCdstringOptional

Excel Download Reason Code

indInfoQryCausstringOptional

Excel Download Reason

trgmnSeqstringOptional

Target Sequence No.

Example: 1

evtTrgmnGbCdstring · enumOptional

Event Target Classification Code (EV012)

Example: 04Possible values:

mbrNostringOptional

Member No.

Example: 100000

winRnkstringOptional

Winning Rank

Example: 1

winCnclCausContstringOptional

Winning Cancellation Reason Content

Example: 주문취소하여구매금액미달

evtNostringOptional

Event No.

Example: 15322

waitRnkstringOptional

Waitlist Rank

Example: 10

intxstringOptional

Income Tax

Example: 500000

citxstringOptional

Local Income Tax

Example: 30000

ordSumAmtstringOptional

Total Order Amount

Example: 50000

cfmOrdAmtstringOptional

Confirmed Order Amount

Example: 40000

evtSbscPathCdstring · enumOptional

Event Application Channel Code (OM007)

Example: 20Possible values:

tubaBankCdstring · enumOptional

Tax and Public Dues Bank Code (OM026)

Example: 104Possible values:

tubaDepositorNmstringOptional

Tax Withholding Account Holder Name

Example: 김아무개

tubaVirActnNostringOptional

Tax Withholding Virtual Account No.

Example: 11111-222-333-44

tubaDptAmtstringOptional

Tax Withholding Deposit Amount

Example: 50000

deliHdcCdstring · enumOptional

Delivery Courier Company Code (LO005)

Example: 10Possible values:

deliInvNostringOptional

Delivery Tracking No.

Example: 1141212314

mailSndCntstringOptional

Email Send Count

Example: 10

bbcNostringOptional

Post Number

Example: 114

lotCondSeqstringOptional

Drawing Condition Sequence No.

Example: 2

mbrNoListstring[]Optional

Member No. List

Example: [10000000,10000001,10000002]

mbrNmstringOptional

Member Name

Example: 홍길동

loginIdstringOptional

Member ID

Example: abc

cellNostringOptional

Mobile Phone Number

Example: 01011112222

cellSctNostringOptional

Mobile Phone Prefix Code

Example: 010

cellTxnoNostringOptional

Mobile Phone Exchange Code

Example: 1111

cellEndNostringOptional

Mobile Phone Last Digits

Example: 2222

lotObjCdstring · enumOptional

Drawing Purpose (EV022)

Example: 10Possible values:

lotExcpStafYnstringOptional

Exclude Employees from Drawing Target Status

Example: Y

trgmnSeqListstring[]Optional

Entry No.

Example: [100,101,102,103]

trgmnSeqArrstringOptional

Entry No.

Example: 100

lotTargetNuminteger · int32Optional

Number of Drawing Targets

Example: 100

lotLimitNuminteger · int32Optional

Number of Winners by Prize Benefit

Example: 50

evtMgrpCdstring · enumOptional

Event Type (EV002)

Example: 30Possible values:

buyAmtinteger · int32Optional

Purchase Amount

Example: 50000

setTypestringOptional

Win & Win Cancellation

Example: 10

lotTypestringOptional

Drawing Type: Draw:LL, Redraw:RL, Add to Waitlist:WA, Waitlist Draw:WL, Waitlist Win Cancellation:WC, Waitlist Redraw:WR

sndMethCdstring · enumOptional

Send Method Code (EV013)

Example: 01Possible values:

rcvmnNmstringOptional

Prize Recipient Name

Example: 김아무개

deliZipNostringOptional

Prize Delivery Address Postal Code

Example: 12345

deliZipAddrstringOptional

Prize Receiving Address

Example: 서울시 아무구 아무동 1번

deliZipDtlAddrstringOptional

Prize Receiving Address

Example: 아무건물 302호

deliTelNostringOptional

Prize Recipient Phone No.

Example: 021234567

deliTelRgnNostringOptional

Prize Recipient Phone Area Code

Example: 02

deliTelTxnoNostringOptional

Prize Recipient Phone Exchange No.

Example: 123

deliTelEndNostringOptional

Prize Recipient Phone Last Digits

Example: 4567

deliCellNostringOptional

Prize Recipient Mobile Phone No.

Example: 01011112222

deliCellSctNostringOptional

Prize Delivery Address Mobile Phone Prefix

Example: 010

deliCellTxnoNostringOptional

Prize Delivery Address Mobile Phone Middle Digits

Example: 1111

deliCellEndNostringOptional

Prize Delivery Address Mobile Phone Last Digits

Example: 2222

realGoodsstringOptional

Physical Prize

Example: 1002304

evtNmstringOptional

Event Name

Example: 이벤트

aempIdstringOptional

Event Manager

Example: 1002304

startDatestringOptional

Entry Period Start Date

endDatestringOptional

Entry Period End Date

excelHeaderstringOptional

Excel Header

winCnclDtmstring · date-timeOptional

Winning Cancellation Date/Time

winDtmstring · date-timeOptional

Winning Date/Time

myCertiDtmstring · date-timeOptional

Identity Verification Date/Time

sbscAplyDtmstring · date-timeOptional

Application Date/Time

wtpsSltDtmstring · date-timeOptional

Waitlist Selection Date/Time

tubaDptDtmstring · date-timeOptional

Tax Withholding Deposit Date/Time

buyStrDtmstring · date-timeOptional

Purchase Period Start Date/Time

buyEndDtmstring · date-timeOptional

Purchase Period End Date/Time

alarmStatusYnstringOptional

Notification Talk/Notification Usage Status

Example: Y

evtFvrTypCdstring · enumOptional

Event Benefit Type Code (EV011)

Example: 10Possible values:

sbscPsbMinOrdAmtnumberOptional

Minimum Order Payment Amount for Entry

Responses

200

Mileage Payment Request Success

*/*

stringOptional

900

Mileage Payment Request Failure

*/*

post/v1/marketing/eventMgmt/saveEventMgmtMilgPaymentRequest

POST /api/bo/v1/marketing/eventMgmt/saveEventMgmtMilgPaymentRequest HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1774

{
  "qryGbCd": "text",
  "indInfoQryCaus": "text",
  "trgmnSeq": 1,
  "evtTrgmnGbCd": "04",
  "mbrNo": 100000,
  "winRnk": 1,
  "winCnclCausCont": "주문취소하여구매금액미달",
  "evtNo": 15322,
  "waitRnk": 10,
  "intx": 500000,
  "citx": 30000,
  "ordSumAmt": 50000,
  "cfmOrdAmt": 40000,
  "evtSbscPathCd": 20,
  "tubaBankCd": 104,
  "tubaDepositorNm": "김아무개",
  "tubaVirActnNo": "11111-222-333-44",
  "tubaDptAmt": 50000,
  "deliHdcCd": 10,
  "deliInvNo": 1141212314,
  "mailSndCnt": 10,
  "bbcNo": 114,
  "lotCondSeq": 2,
  "mbrNoList": [
    10000000,
    10000001,
    10000002
  ],
  "mbrNm": "홍길동",
  "loginId": "abc",
  "cellNo": "01011112222",
  "cellSctNo": "010",
  "cellTxnoNo": 1111,
  "cellEndNo": 2222,
  "lotObjCd": 10,
  "lotExcpStafYn": "Y",
  "trgmnSeqList": [
    100,
    101,
    102,
    103
  ],
  "trgmnSeqArr": 100,
  "lotTargetNum": 100,
  "lotLimitNum": 50,
  "evtMgrpCd": 30,
  "buyAmt": 50000,
  "setType": 10,
  "lotType": "text",
  "sndMethCd": "01",
  "rcvmnNm": "김아무개",
  "deliZipNo": 12345,
  "deliZipAddr": "서울시 아무구 아무동 1번",
  "deliZipDtlAddr": "아무건물 302호",
  "deliTelNo": "021234567",
  "deliTelRgnNo": "02",
  "deliTelTxnoNo": 123,
  "deliTelEndNo": 4567,
  "deliCellNo": "01011112222",
  "deliCellSctNo": "010",
  "deliCellTxnoNo": 1111,
  "deliCellEndNo": 2222,
  "realGoods": 1002304,
  "evtNm": "이벤트",
  "aempId": 1002304,
  "startDate": "text",
  "endDate": "text",
  "excelHeader": "text",
  "winCnclDtm": "2026-01-01T00:00:00.000Z",
  "winDtm": "2026-01-01T00:00:00.000Z",
  "myCertiDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
  "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
  "tubaDptDtm": "2026-01-01T00:00:00.000Z",
  "buyStrDtm": "2026-01-01T00:00:00.000Z",
  "buyEndDtm": "2026-01-01T00:00:00.000Z",
  "alarmStatusYn": "Y",
  "evtFvrTypCd": 10,
  "sbscPsbMinOrdAmt": 1,
  "dataList": [
    {
      "evtFvrSeq": 1,
      "evtNo": 15322,
      "mbrNo": 1000000,
      "lotGb": "04",
      "trgmnSeq": 1,
      "loginId": "abde",
      "mbrNm": "김아무개",
      "mbrSexGb": "M",
      "mbrAge": 19,
      "cellNo": "01011112222"
    }
  ]
}

text

Send Email to Event Winners

post

Function Description

• Sends an email to event winners.

---

Detailed Description

• Sends an email to the email address of the winner's account for the event.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

evtNostringOptional

Event No.

evtNmstringOptional

Event Name

trgmnSeqstringOptional

Entrant Sequence No.

sndSeqstringOptional

Send Sequence No.

sndMethCdstring · enumOptional

Send Method Code (EV013)

Example: 01Possible values:

sndYnstringOptional

Sending Status

sndTmplCdstringOptional

Send Template Code

emailTitleNmstringOptional

Email Subject

sndContstringOptional

Send Content

evtTermExpYnstringOptional

Promotion Period Display Status

sbscTermExpYnstringOptional

Application Period Display Status

winAncmDtExpYnstringOptional

Winner Announcement Date Display Status

sndDtExpYnstringOptional

Send Date Display Status

lotListDpYnstringOptional

Winning Details Display Status

lotListContstringOptional

Winning Details Content

winAncmDtstringOptional

Winner Announcement Date/Time

payDtstringOptional

Payment Date

pmgdSndDtstringOptional

Send Date

tubaDptStrDtstringOptional

Tax and Public Dues Payment Deadline Start Date

tubaDptEndDtstringOptional

Tax and Public Dues Payment Deadline End Date

additionalAreaContstringOptional

Additional Area Content

sndDtmstring · date-timeOptional

Send Date/Time

sndTestDtmstring · date-timeOptional

Send Test Date and Time

evtStrDtmstring · date-timeOptional

Promotion Period Start Date

evtEndDtmstring · date-timeOptional

Promotion Period End Date

sbscAplyStrDtmstring · date-timeOptional

Application Period Start Date

sbscAplyEndDtmstring · date-timeOptional

Application Period End Date

Responses

200

Email Sent Successfully

*/*

stringOptional

900

Email Send Failure

*/*

post/v1/marketing/eventMgmt/saveEventMgmtLotWinnerEmailSend

POST /api/bo/v1/marketing/eventMgmt/saveEventMgmtLotWinnerEmailSend HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 768

{
  "evtNo": "text",
  "evtNm": "text",
  "trgmnSeq": "text",
  "sndSeq": "text",
  "sndMethCd": "01",
  "sndYn": "text",
  "sndTmplCd": "text",
  "emailTitleNm": "text",
  "sndCont": "text",
  "evtTermExpYn": "text",
  "sbscTermExpYn": "text",
  "winAncmDtExpYn": "text",
  "sndDtExpYn": "text",
  "lotListDpYn": "text",
  "lotListCont": "text",
  "winAncmDt": "text",
  "payDt": "text",
  "pmgdSndDt": "text",
  "tubaDptStrDt": "text",
  "tubaDptEndDt": "text",
  "additionalAreaCont": "text",
  "trgmnInfoList": [
    {
      "evtNo": 15322,
      "trgmnSeq": 1,
      "sndSeq": 1,
      "resndYn": "N",
      "resndCausCd": "02",
      "emailAddr": "[e-mail]"
    }
  ],
  "sndDtm": "2026-01-01T00:00:00.000Z",
  "sndTestDtm": "2026-01-01T00:00:00.000Z",
  "evtStrDtm": "2026-01-01T00:00:00.000Z",
  "evtEndDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyEndDtm": "2026-01-01T00:00:00.000Z"
}

text

Save Event Winning Cancellation

post

Function Description

• Saves the winning cancellation for an event.

---

Detailed Description

• Event No. (evtNo), Applicant Sequence No. (trgmnSeq) are required.

• Saves the winning cancellation of an applicant for the event using the evtNo parameter.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

qryGbCdstringOptional

Excel Download Reason Code

indInfoQryCausstringOptional

Excel Download Reason

trgmnSeqstringOptional

Target Sequence No.

Example: 1

evtTrgmnGbCdstring · enumOptional

Event Target Classification Code (EV012)

Example: 04Possible values:

mbrNostringOptional

Member No.

Example: 100000

winRnkstringOptional

Winning Rank

Example: 1

winCnclCausContstringOptional

Winning Cancellation Reason Content

Example: 주문취소하여구매금액미달

evtNostringOptional

Event No.

Example: 15322

waitRnkstringOptional

Waitlist Rank

Example: 10

intxstringOptional

Income Tax

Example: 500000

citxstringOptional

Local Income Tax

Example: 30000

ordSumAmtstringOptional

Total Order Amount

Example: 50000

cfmOrdAmtstringOptional

Confirmed Order Amount

Example: 40000

evtSbscPathCdstring · enumOptional

Event Application Channel Code (OM007)

Example: 20Possible values:

tubaBankCdstring · enumOptional

Tax and Public Dues Bank Code (OM026)

Example: 104Possible values:

tubaDepositorNmstringOptional

Tax Withholding Account Holder Name

Example: 김아무개

tubaVirActnNostringOptional

Tax Withholding Virtual Account No.

Example: 11111-222-333-44

tubaDptAmtstringOptional

Tax Withholding Deposit Amount

Example: 50000

deliHdcCdstring · enumOptional

Delivery Courier Company Code (LO005)

Example: 10Possible values:

deliInvNostringOptional

Delivery Tracking No.

Example: 1141212314

mailSndCntstringOptional

Email Send Count

Example: 10

bbcNostringOptional

Post Number

Example: 114

lotCondSeqstringOptional

Drawing Condition Sequence No.

Example: 2

mbrNoListstring[]Optional

Member No. List

Example: [10000000,10000001,10000002]

mbrNmstringOptional

Member Name

Example: 홍길동

loginIdstringOptional

Member ID

Example: abc

cellNostringOptional

Mobile Phone Number

Example: 01011112222

cellSctNostringOptional

Mobile Phone Prefix Code

Example: 010

cellTxnoNostringOptional

Mobile Phone Exchange Code

Example: 1111

cellEndNostringOptional

Mobile Phone Last Digits

Example: 2222

lotObjCdstring · enumOptional

Drawing Purpose (EV022)

Example: 10Possible values:

lotExcpStafYnstringOptional

Exclude Employees from Drawing Target Status

Example: Y

trgmnSeqListstring[]Optional

Entry No.

Example: [100,101,102,103]

trgmnSeqArrstringOptional

Entry No.

Example: 100

lotTargetNuminteger · int32Optional

Number of Drawing Targets

Example: 100

lotLimitNuminteger · int32Optional

Number of Winners by Prize Benefit

Example: 50

evtMgrpCdstring · enumOptional

Event Type (EV002)

Example: 30Possible values:

buyAmtinteger · int32Optional

Purchase Amount

Example: 50000

setTypestringOptional

Win & Win Cancellation

Example: 10

lotTypestringOptional

Drawing Type: Draw:LL, Redraw:RL, Add to Waitlist:WA, Waitlist Draw:WL, Waitlist Win Cancellation:WC, Waitlist Redraw:WR

sndMethCdstring · enumOptional

Send Method Code (EV013)

Example: 01Possible values:

rcvmnNmstringOptional

Prize Recipient Name

Example: 김아무개

deliZipNostringOptional

Prize Delivery Address Postal Code

Example: 12345

deliZipAddrstringOptional

Prize Receiving Address

Example: 서울시 아무구 아무동 1번

deliZipDtlAddrstringOptional

Prize Receiving Address

Example: 아무건물 302호

deliTelNostringOptional

Prize Recipient Phone No.

Example: 021234567

deliTelRgnNostringOptional

Prize Recipient Phone Area Code

Example: 02

deliTelTxnoNostringOptional

Prize Recipient Phone Exchange No.

Example: 123

deliTelEndNostringOptional

Prize Recipient Phone Last Digits

Example: 4567

deliCellNostringOptional

Prize Recipient Mobile Phone No.

Example: 01011112222

deliCellSctNostringOptional

Prize Delivery Address Mobile Phone Prefix

Example: 010

deliCellTxnoNostringOptional

Prize Delivery Address Mobile Phone Middle Digits

Example: 1111

deliCellEndNostringOptional

Prize Delivery Address Mobile Phone Last Digits

Example: 2222

realGoodsstringOptional

Physical Prize

Example: 1002304

evtNmstringOptional

Event Name

Example: 이벤트

aempIdstringOptional

Event Manager

Example: 1002304

startDatestringOptional

Entry Period Start Date

endDatestringOptional

Entry Period End Date

excelHeaderstringOptional

Excel Header

winCnclDtmstring · date-timeOptional

Winning Cancellation Date/Time

winDtmstring · date-timeOptional

Winning Date/Time

myCertiDtmstring · date-timeOptional

Identity Verification Date/Time

sbscAplyDtmstring · date-timeOptional

Application Date/Time

wtpsSltDtmstring · date-timeOptional

Waitlist Selection Date/Time

tubaDptDtmstring · date-timeOptional

Tax Withholding Deposit Date/Time

buyStrDtmstring · date-timeOptional

Purchase Period Start Date/Time

buyEndDtmstring · date-timeOptional

Purchase Period End Date/Time

alarmStatusYnstringOptional

Notification Talk/Notification Usage Status

Example: Y

evtFvrTypCdstring · enumOptional

Event Benefit Type Code (EV011)

Example: 10Possible values:

sbscPsbMinOrdAmtnumberOptional

Minimum Order Payment Amount for Entry

Responses

200

Winning Cancellation Success

*/*

stringOptional

900

Winning Cancellation Failure

*/*

post/v1/marketing/eventMgmt/saveEventMgmtLotCnclCont

POST /api/bo/v1/marketing/eventMgmt/saveEventMgmtLotCnclCont HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1774

{
  "qryGbCd": "text",
  "indInfoQryCaus": "text",
  "trgmnSeq": 1,
  "evtTrgmnGbCd": "04",
  "mbrNo": 100000,
  "winRnk": 1,
  "winCnclCausCont": "주문취소하여구매금액미달",
  "evtNo": 15322,
  "waitRnk": 10,
  "intx": 500000,
  "citx": 30000,
  "ordSumAmt": 50000,
  "cfmOrdAmt": 40000,
  "evtSbscPathCd": 20,
  "tubaBankCd": 104,
  "tubaDepositorNm": "김아무개",
  "tubaVirActnNo": "11111-222-333-44",
  "tubaDptAmt": 50000,
  "deliHdcCd": 10,
  "deliInvNo": 1141212314,
  "mailSndCnt": 10,
  "bbcNo": 114,
  "lotCondSeq": 2,
  "mbrNoList": [
    10000000,
    10000001,
    10000002
  ],
  "mbrNm": "홍길동",
  "loginId": "abc",
  "cellNo": "01011112222",
  "cellSctNo": "010",
  "cellTxnoNo": 1111,
  "cellEndNo": 2222,
  "lotObjCd": 10,
  "lotExcpStafYn": "Y",
  "trgmnSeqList": [
    100,
    101,
    102,
    103
  ],
  "trgmnSeqArr": 100,
  "lotTargetNum": 100,
  "lotLimitNum": 50,
  "evtMgrpCd": 30,
  "buyAmt": 50000,
  "setType": 10,
  "lotType": "text",
  "sndMethCd": "01",
  "rcvmnNm": "김아무개",
  "deliZipNo": 12345,
  "deliZipAddr": "서울시 아무구 아무동 1번",
  "deliZipDtlAddr": "아무건물 302호",
  "deliTelNo": "021234567",
  "deliTelRgnNo": "02",
  "deliTelTxnoNo": 123,
  "deliTelEndNo": 4567,
  "deliCellNo": "01011112222",
  "deliCellSctNo": "010",
  "deliCellTxnoNo": 1111,
  "deliCellEndNo": 2222,
  "realGoods": 1002304,
  "evtNm": "이벤트",
  "aempId": 1002304,
  "startDate": "text",
  "endDate": "text",
  "excelHeader": "text",
  "winCnclDtm": "2026-01-01T00:00:00.000Z",
  "winDtm": "2026-01-01T00:00:00.000Z",
  "myCertiDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
  "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
  "tubaDptDtm": "2026-01-01T00:00:00.000Z",
  "buyStrDtm": "2026-01-01T00:00:00.000Z",
  "buyEndDtm": "2026-01-01T00:00:00.000Z",
  "alarmStatusYn": "Y",
  "evtFvrTypCd": 10,
  "sbscPsbMinOrdAmt": 1,
  "dataList": [
    {
      "evtFvrSeq": 1,
      "evtNo": 15322,
      "mbrNo": 1000000,
      "lotGb": "04",
      "trgmnSeq": 1,
      "loginId": "abde",
      "mbrNm": "김아무개",
      "mbrSexGb": "M",
      "mbrAge": 19,
      "cellNo": "01011112222"
    }
  ]
}

text

Save Event Management List Grid

post

Function Description

• Saves the Event Management list grid.

---

Detailed Description

• Event No. (evtNo) is required.

• Applies deleted rows.

• Deletes all event-related information for the event identified by the evtNo value.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

Responses

200

Grid Saved Successfully

*/*

stringOptional

900

Grid Save Failed

*/*

post/v1/marketing/eventMgmt/saveEventMgmtList

POST /api/bo/v1/marketing/eventMgmt/saveEventMgmtList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 5470

{
  "all": [
    {
      "evtNo": "text",
      "evtNm": "text",
      "evtLgrpCd": 20,
      "evtMgrpCd": 30,
      "evtExpNmCd": "01",
      "evtObjCd": "01",
      "evtSbscPsbCd": "01",
      "evtGbCd": "01",
      "sbscCntLmtCd": "02",
      "deptCd": "text",
      "evtPrgsStat": "01",
      "purAmtEvtPromoYn": "text",
      "evetTermDesc": "text",
      "evetCondDesc": "text",
      "paysTermDesc": "text",
      "aeDesc": "text",
      "lotDt": "text",
      "winAncmDt": "text",
      "winAncmDispYn": "text",
      "pmgdSndDt": "text",
      "payDt": "text",
      "evtUrlAddr": "text",
      "evtBnrPathNm": "text",
      "evtBnrFileNm": "text",
      "evtBnrAltCont": "text",
      "pcEvtBnrPathNm": "text",
      "pcEvtBnrFileNm": "text",
      "pcEvtBnrAltCont": "text",
      "aempId": "text",
      "adveWrdCont": "text",
      "pmgdRcvProeCont": "text",
      "dispYn": "text",
      "expYn": "text",
      "evtSchTag": "text",
      "indInfoMkusAgrYn": "text",
      "indInfoMkusAgmt": "text",
      "indInfoThprPofAgrYn": "text",
      "indInfoThprPofAgmt": "text",
      "rnkMgrYn": "text",
      "uprFixYn": "text",
      "evtTmplUseYn": "text",
      "evtExpMsg": "text",
      "atndMtr": "text",
      "custCntrGdWrdCont": "text",
      "acdnUseYn": "text",
      "evtStrDtm": "2026-01-01T00:00:00.000Z",
      "evtEndDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptStrDt": "2026-01-01T00:00:00.000Z",
      "tubaDptEndDt": "2026-01-01T00:00:00.000Z",
      "stmpEdtnNcnt": 1,
      "stmpngStdAmt": 1,
      "stmpngOrdCondCd": "text",
      "stmpngMaxLmtNmb": 1,
      "stmpngDdCondCd": "text",
      "sbscPsbMinOrdAmt": 1
    }
  ],
  "create": [
    {
      "evtNo": "text",
      "evtNm": "text",
      "evtLgrpCd": 20,
      "evtMgrpCd": 30,
      "evtExpNmCd": "01",
      "evtObjCd": "01",
      "evtSbscPsbCd": "01",
      "evtGbCd": "01",
      "sbscCntLmtCd": "02",
      "deptCd": "text",
      "evtPrgsStat": "01",
      "purAmtEvtPromoYn": "text",
      "evetTermDesc": "text",
      "evetCondDesc": "text",
      "paysTermDesc": "text",
      "aeDesc": "text",
      "lotDt": "text",
      "winAncmDt": "text",
      "winAncmDispYn": "text",
      "pmgdSndDt": "text",
      "payDt": "text",
      "evtUrlAddr": "text",
      "evtBnrPathNm": "text",
      "evtBnrFileNm": "text",
      "evtBnrAltCont": "text",
      "pcEvtBnrPathNm": "text",
      "pcEvtBnrFileNm": "text",
      "pcEvtBnrAltCont": "text",
      "aempId": "text",
      "adveWrdCont": "text",
      "pmgdRcvProeCont": "text",
      "dispYn": "text",
      "expYn": "text",
      "evtSchTag": "text",
      "indInfoMkusAgrYn": "text",
      "indInfoMkusAgmt": "text",
      "indInfoThprPofAgrYn": "text",
      "indInfoThprPofAgmt": "text",
      "rnkMgrYn": "text",
      "uprFixYn": "text",
      "evtTmplUseYn": "text",
      "evtExpMsg": "text",
      "atndMtr": "text",
      "custCntrGdWrdCont": "text",
      "acdnUseYn": "text",
      "evtStrDtm": "2026-01-01T00:00:00.000Z",
      "evtEndDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptStrDt": "2026-01-01T00:00:00.000Z",
      "tubaDptEndDt": "2026-01-01T00:00:00.000Z",
      "stmpEdtnNcnt": 1,
      "stmpngStdAmt": 1,
      "stmpngOrdCondCd": "text",
      "stmpngMaxLmtNmb": 1,
      "stmpngDdCondCd": "text",
      "sbscPsbMinOrdAmt": 1
    }
  ],
  "update": [
    {
      "evtNo": "text",
      "evtNm": "text",
      "evtLgrpCd": 20,
      "evtMgrpCd": 30,
      "evtExpNmCd": "01",
      "evtObjCd": "01",
      "evtSbscPsbCd": "01",
      "evtGbCd": "01",
      "sbscCntLmtCd": "02",
      "deptCd": "text",
      "evtPrgsStat": "01",
      "purAmtEvtPromoYn": "text",
      "evetTermDesc": "text",
      "evetCondDesc": "text",
      "paysTermDesc": "text",
      "aeDesc": "text",
      "lotDt": "text",
      "winAncmDt": "text",
      "winAncmDispYn": "text",
      "pmgdSndDt": "text",
      "payDt": "text",
      "evtUrlAddr": "text",
      "evtBnrPathNm": "text",
      "evtBnrFileNm": "text",
      "evtBnrAltCont": "text",
      "pcEvtBnrPathNm": "text",
      "pcEvtBnrFileNm": "text",
      "pcEvtBnrAltCont": "text",
      "aempId": "text",
      "adveWrdCont": "text",
      "pmgdRcvProeCont": "text",
      "dispYn": "text",
      "expYn": "text",
      "evtSchTag": "text",
      "indInfoMkusAgrYn": "text",
      "indInfoMkusAgmt": "text",
      "indInfoThprPofAgrYn": "text",
      "indInfoThprPofAgmt": "text",
      "rnkMgrYn": "text",
      "uprFixYn": "text",
      "evtTmplUseYn": "text",
      "evtExpMsg": "text",
      "atndMtr": "text",
      "custCntrGdWrdCont": "text",
      "acdnUseYn": "text",
      "evtStrDtm": "2026-01-01T00:00:00.000Z",
      "evtEndDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptStrDt": "2026-01-01T00:00:00.000Z",
      "tubaDptEndDt": "2026-01-01T00:00:00.000Z",
      "stmpEdtnNcnt": 1,
      "stmpngStdAmt": 1,
      "stmpngOrdCondCd": "text",
      "stmpngMaxLmtNmb": 1,
      "stmpngDdCondCd": "text",
      "sbscPsbMinOrdAmt": 1
    }
  ],
  "delete": [
    {
      "evtNo": "text",
      "evtNm": "text",
      "evtLgrpCd": 20,
      "evtMgrpCd": 30,
      "evtExpNmCd": "01",
      "evtObjCd": "01",
      "evtSbscPsbCd": "01",
      "evtGbCd": "01",
      "sbscCntLmtCd": "02",
      "deptCd": "text",
      "evtPrgsStat": "01",
      "purAmtEvtPromoYn": "text",
      "evetTermDesc": "text",
      "evetCondDesc": "text",
      "paysTermDesc": "text",
      "aeDesc": "text",
      "lotDt": "text",
      "winAncmDt": "text",
      "winAncmDispYn": "text",
      "pmgdSndDt": "text",
      "payDt": "text",
      "evtUrlAddr": "text",
      "evtBnrPathNm": "text",
      "evtBnrFileNm": "text",
      "evtBnrAltCont": "text",
      "pcEvtBnrPathNm": "text",
      "pcEvtBnrFileNm": "text",
      "pcEvtBnrAltCont": "text",
      "aempId": "text",
      "adveWrdCont": "text",
      "pmgdRcvProeCont": "text",
      "dispYn": "text",
      "expYn": "text",
      "evtSchTag": "text",
      "indInfoMkusAgrYn": "text",
      "indInfoMkusAgmt": "text",
      "indInfoThprPofAgrYn": "text",
      "indInfoThprPofAgmt": "text",
      "rnkMgrYn": "text",
      "uprFixYn": "text",
      "evtTmplUseYn": "text",
      "evtExpMsg": "text",
      "atndMtr": "text",
      "custCntrGdWrdCont": "text",
      "acdnUseYn": "text",
      "evtStrDtm": "2026-01-01T00:00:00.000Z",
      "evtEndDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptStrDt": "2026-01-01T00:00:00.000Z",
      "tubaDptEndDt": "2026-01-01T00:00:00.000Z",
      "stmpEdtnNcnt": 1,
      "stmpngStdAmt": 1,
      "stmpngOrdCondCd": "text",
      "stmpngMaxLmtNmb": 1,
      "stmpngDdCondCd": "text",
      "sbscPsbMinOrdAmt": 1
    }
  ]
}

text

Event Winner Coupon Payment Completed

post

Function Description

• Marks coupon payment as completed for event winners

---

Detailed Description

• Event No. (evtNo) is required.

• Issues a coupon to the winner.

• Marks the winner as payment completed.

• Sends a notification to the winner.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

qryGbCdstringOptional

Excel Download Reason Code

indInfoQryCausstringOptional

Excel Download Reason

trgmnSeqstringOptional

Target Sequence No.

Example: 1

evtTrgmnGbCdstring · enumOptional

Event Target Classification Code (EV012)

Example: 04Possible values:

mbrNostringOptional

Member No.

Example: 100000

winRnkstringOptional

Winning Rank

Example: 1

winCnclCausContstringOptional

Winning Cancellation Reason Content

Example: 주문취소하여구매금액미달

evtNostringOptional

Event No.

Example: 15322

waitRnkstringOptional

Waitlist Rank

Example: 10

intxstringOptional

Income Tax

Example: 500000

citxstringOptional

Local Income Tax

Example: 30000

ordSumAmtstringOptional

Total Order Amount

Example: 50000

cfmOrdAmtstringOptional

Confirmed Order Amount

Example: 40000

evtSbscPathCdstring · enumOptional

Event Application Channel Code (OM007)

Example: 20Possible values:

tubaBankCdstring · enumOptional

Tax and Public Dues Bank Code (OM026)

Example: 104Possible values:

tubaDepositorNmstringOptional

Tax Withholding Account Holder Name

Example: 김아무개

tubaVirActnNostringOptional

Tax Withholding Virtual Account No.

Example: 11111-222-333-44

tubaDptAmtstringOptional

Tax Withholding Deposit Amount

Example: 50000

deliHdcCdstring · enumOptional

Delivery Courier Company Code (LO005)

Example: 10Possible values:

deliInvNostringOptional

Delivery Tracking No.

Example: 1141212314

mailSndCntstringOptional

Email Send Count

Example: 10

bbcNostringOptional

Post Number

Example: 114

lotCondSeqstringOptional

Drawing Condition Sequence No.

Example: 2

mbrNoListstring[]Optional

Member No. List

Example: [10000000,10000001,10000002]

mbrNmstringOptional

Member Name

Example: 홍길동

loginIdstringOptional

Member ID

Example: abc

cellNostringOptional

Mobile Phone Number

Example: 01011112222

cellSctNostringOptional

Mobile Phone Prefix Code

Example: 010

cellTxnoNostringOptional

Mobile Phone Exchange Code

Example: 1111

cellEndNostringOptional

Mobile Phone Last Digits

Example: 2222

lotObjCdstring · enumOptional

Drawing Purpose (EV022)

Example: 10Possible values:

lotExcpStafYnstringOptional

Exclude Employees from Drawing Target Status

Example: Y

trgmnSeqListstring[]Optional

Entry No.

Example: [100,101,102,103]

trgmnSeqArrstringOptional

Entry No.

Example: 100

lotTargetNuminteger · int32Optional

Number of Drawing Targets

Example: 100

lotLimitNuminteger · int32Optional

Number of Winners by Prize Benefit

Example: 50

evtMgrpCdstring · enumOptional

Event Type (EV002)

Example: 30Possible values:

buyAmtinteger · int32Optional

Purchase Amount

Example: 50000

setTypestringOptional

Win & Win Cancellation

Example: 10

lotTypestringOptional

Drawing Type: Draw:LL, Redraw:RL, Add to Waitlist:WA, Waitlist Draw:WL, Waitlist Win Cancellation:WC, Waitlist Redraw:WR

sndMethCdstring · enumOptional

Send Method Code (EV013)

Example: 01Possible values:

rcvmnNmstringOptional

Prize Recipient Name

Example: 김아무개

deliZipNostringOptional

Prize Delivery Address Postal Code

Example: 12345

deliZipAddrstringOptional

Prize Receiving Address

Example: 서울시 아무구 아무동 1번

deliZipDtlAddrstringOptional

Prize Receiving Address

Example: 아무건물 302호

deliTelNostringOptional

Prize Recipient Phone No.

Example: 021234567

deliTelRgnNostringOptional

Prize Recipient Phone Area Code

Example: 02

deliTelTxnoNostringOptional

Prize Recipient Phone Exchange No.

Example: 123

deliTelEndNostringOptional

Prize Recipient Phone Last Digits

Example: 4567

deliCellNostringOptional

Prize Recipient Mobile Phone No.

Example: 01011112222

deliCellSctNostringOptional

Prize Delivery Address Mobile Phone Prefix

Example: 010

deliCellTxnoNostringOptional

Prize Delivery Address Mobile Phone Middle Digits

Example: 1111

deliCellEndNostringOptional

Prize Delivery Address Mobile Phone Last Digits

Example: 2222

realGoodsstringOptional

Physical Prize

Example: 1002304

evtNmstringOptional

Event Name

Example: 이벤트

aempIdstringOptional

Event Manager

Example: 1002304

startDatestringOptional

Entry Period Start Date

endDatestringOptional

Entry Period End Date

excelHeaderstringOptional

Excel Header

winCnclDtmstring · date-timeOptional

Winning Cancellation Date/Time

winDtmstring · date-timeOptional

Winning Date/Time

myCertiDtmstring · date-timeOptional

Identity Verification Date/Time

sbscAplyDtmstring · date-timeOptional

Application Date/Time

wtpsSltDtmstring · date-timeOptional

Waitlist Selection Date/Time

tubaDptDtmstring · date-timeOptional

Tax Withholding Deposit Date/Time

buyStrDtmstring · date-timeOptional

Purchase Period Start Date/Time

buyEndDtmstring · date-timeOptional

Purchase Period End Date/Time

alarmStatusYnstringOptional

Notification Talk/Notification Usage Status

Example: Y

evtFvrTypCdstring · enumOptional

Event Benefit Type Code (EV011)

Example: 10Possible values:

sbscPsbMinOrdAmtnumberOptional

Minimum Order Payment Amount for Entry

Responses

200

Coupon Payment Completion Success

*/*

stringOptional

900

Coupon Payment Completion Failure

*/*

post/v1/marketing/eventMgmt/saveEventMgmtCouponRequest

POST /api/bo/v1/marketing/eventMgmt/saveEventMgmtCouponRequest HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1774

{
  "qryGbCd": "text",
  "indInfoQryCaus": "text",
  "trgmnSeq": 1,
  "evtTrgmnGbCd": "04",
  "mbrNo": 100000,
  "winRnk": 1,
  "winCnclCausCont": "주문취소하여구매금액미달",
  "evtNo": 15322,
  "waitRnk": 10,
  "intx": 500000,
  "citx": 30000,
  "ordSumAmt": 50000,
  "cfmOrdAmt": 40000,
  "evtSbscPathCd": 20,
  "tubaBankCd": 104,
  "tubaDepositorNm": "김아무개",
  "tubaVirActnNo": "11111-222-333-44",
  "tubaDptAmt": 50000,
  "deliHdcCd": 10,
  "deliInvNo": 1141212314,
  "mailSndCnt": 10,
  "bbcNo": 114,
  "lotCondSeq": 2,
  "mbrNoList": [
    10000000,
    10000001,
    10000002
  ],
  "mbrNm": "홍길동",
  "loginId": "abc",
  "cellNo": "01011112222",
  "cellSctNo": "010",
  "cellTxnoNo": 1111,
  "cellEndNo": 2222,
  "lotObjCd": 10,
  "lotExcpStafYn": "Y",
  "trgmnSeqList": [
    100,
    101,
    102,
    103
  ],
  "trgmnSeqArr": 100,
  "lotTargetNum": 100,
  "lotLimitNum": 50,
  "evtMgrpCd": 30,
  "buyAmt": 50000,
  "setType": 10,
  "lotType": "text",
  "sndMethCd": "01",
  "rcvmnNm": "김아무개",
  "deliZipNo": 12345,
  "deliZipAddr": "서울시 아무구 아무동 1번",
  "deliZipDtlAddr": "아무건물 302호",
  "deliTelNo": "021234567",
  "deliTelRgnNo": "02",
  "deliTelTxnoNo": 123,
  "deliTelEndNo": 4567,
  "deliCellNo": "01011112222",
  "deliCellSctNo": "010",
  "deliCellTxnoNo": 1111,
  "deliCellEndNo": 2222,
  "realGoods": 1002304,
  "evtNm": "이벤트",
  "aempId": 1002304,
  "startDate": "text",
  "endDate": "text",
  "excelHeader": "text",
  "winCnclDtm": "2026-01-01T00:00:00.000Z",
  "winDtm": "2026-01-01T00:00:00.000Z",
  "myCertiDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
  "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
  "tubaDptDtm": "2026-01-01T00:00:00.000Z",
  "buyStrDtm": "2026-01-01T00:00:00.000Z",
  "buyEndDtm": "2026-01-01T00:00:00.000Z",
  "alarmStatusYn": "Y",
  "evtFvrTypCd": 10,
  "sbscPsbMinOrdAmt": 1,
  "dataList": [
    {
      "evtFvrSeq": 1,
      "evtNo": 15322,
      "mbrNo": 1000000,
      "lotGb": "04",
      "trgmnSeq": 1,
      "loginId": "abde",
      "mbrNm": "김아무개",
      "mbrSexGb": "M",
      "mbrAge": 19,
      "cellNo": "01011112222"
    }
  ]
}

text

Save Event Scope Category Grid

post

Function Description

• Saves the Event Scope category grid.

---

Detailed Description

• Event No. (evtNo), Customer Benefit Application Type Code (EV008) (custFvrAplyGbCd), Customer Benefit Application Category Code (EV009) (custFvrAplyTypCd), Benefit Target No. (fvrTgtNo) are required.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

Responses

200

Grid Saved Successfully

*/*

stringOptional

900

Grid Save Failed

*/*

post/v1/marketing/eventMgmt/saveEventMgmtApplyCategory

POST /api/bo/v1/marketing/eventMgmt/saveEventMgmtApplyCategory HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 562

{
  "all": [
    {
      "evtNo": "text",
      "custFvrAplyGbCd": 10,
      "custFvrAplyTypCd": 10,
      "fvrTgtNo": "text",
      "siteNm": "text",
      "siteDom": "text",
      "applyCont": "text"
    }
  ],
  "create": [
    {
      "evtNo": "text",
      "custFvrAplyGbCd": 10,
      "custFvrAplyTypCd": 10,
      "fvrTgtNo": "text",
      "siteNm": "text",
      "siteDom": "text",
      "applyCont": "text"
    }
  ],
  "update": [
    {
      "evtNo": "text",
      "custFvrAplyGbCd": 10,
      "custFvrAplyTypCd": 10,
      "fvrTgtNo": "text",
      "siteNm": "text",
      "siteDom": "text",
      "applyCont": "text"
    }
  ],
  "delete": [
    {
      "evtNo": "text",
      "custFvrAplyGbCd": 10,
      "custFvrAplyTypCd": 10,
      "fvrTgtNo": "text",
      "siteNm": "text",
      "siteDom": "text",
      "applyCont": "text"
    }
  ]
}

text

Tax and Public Dues Confirmation Processing

post

Function Description

• Performs tax and public dues confirmation processing.

---

Detailed Description

• Event No. (evtNo), Applicant Sequence No. (trgmnSeq), Tax and Public Dues (tuba), Member No. (mbrNo) are required.

• Performs tax and public dues confirmation processing for the applicant of the event.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

qryGbCdstringOptional

Excel Download Reason Code

indInfoQryCausstringOptional

Excel Download Reason

trgmnSeqstringOptional

Target Sequence No.

Example: 1

evtTrgmnGbCdstring · enumOptional

Event Target Classification Code (EV012)

Example: 04Possible values:

mbrNostringOptional

Member No.

Example: 100000

winRnkstringOptional

Winning Rank

Example: 1

winCnclCausContstringOptional

Winning Cancellation Reason Content

Example: 주문취소하여구매금액미달

evtNostringOptional

Event No.

Example: 15322

waitRnkstringOptional

Waitlist Rank

Example: 10

intxstringOptional

Income Tax

Example: 500000

citxstringOptional

Local Income Tax

Example: 30000

ordSumAmtstringOptional

Total Order Amount

Example: 50000

cfmOrdAmtstringOptional

Confirmed Order Amount

Example: 40000

evtSbscPathCdstring · enumOptional

Event Application Channel Code (OM007)

Example: 20Possible values:

tubaBankCdstring · enumOptional

Tax and Public Dues Bank Code (OM026)

Example: 104Possible values:

tubaDepositorNmstringOptional

Tax Withholding Account Holder Name

Example: 김아무개

tubaVirActnNostringOptional

Tax Withholding Virtual Account No.

Example: 11111-222-333-44

tubaDptAmtstringOptional

Tax Withholding Deposit Amount

Example: 50000

deliHdcCdstring · enumOptional

Delivery Courier Company Code (LO005)

Example: 10Possible values:

deliInvNostringOptional

Delivery Tracking No.

Example: 1141212314

mailSndCntstringOptional

Email Send Count

Example: 10

bbcNostringOptional

Post Number

Example: 114

lotCondSeqstringOptional

Drawing Condition Sequence No.

Example: 2

mbrNoListstring[]Optional

Member No. List

Example: [10000000,10000001,10000002]

mbrNmstringOptional

Member Name

Example: 홍길동

loginIdstringOptional

Member ID

Example: abc

cellNostringOptional

Mobile Phone Number

Example: 01011112222

cellSctNostringOptional

Mobile Phone Prefix Code

Example: 010

cellTxnoNostringOptional

Mobile Phone Exchange Code

Example: 1111

cellEndNostringOptional

Mobile Phone Last Digits

Example: 2222

lotObjCdstring · enumOptional

Drawing Purpose (EV022)

Example: 10Possible values:

lotExcpStafYnstringOptional

Exclude Employees from Drawing Target Status

Example: Y

trgmnSeqListstring[]Optional

Entry No.

Example: [100,101,102,103]

trgmnSeqArrstringOptional

Entry No.

Example: 100

lotTargetNuminteger · int32Optional

Number of Drawing Targets

Example: 100

lotLimitNuminteger · int32Optional

Number of Winners by Prize Benefit

Example: 50

evtMgrpCdstring · enumOptional

Event Type (EV002)

Example: 30Possible values:

buyAmtinteger · int32Optional

Purchase Amount

Example: 50000

setTypestringOptional

Win & Win Cancellation

Example: 10

lotTypestringOptional

Drawing Type: Draw:LL, Redraw:RL, Add to Waitlist:WA, Waitlist Draw:WL, Waitlist Win Cancellation:WC, Waitlist Redraw:WR

sndMethCdstring · enumOptional

Send Method Code (EV013)

Example: 01Possible values:

rcvmnNmstringOptional

Prize Recipient Name

Example: 김아무개

deliZipNostringOptional

Prize Delivery Address Postal Code

Example: 12345

deliZipAddrstringOptional

Prize Receiving Address

Example: 서울시 아무구 아무동 1번

deliZipDtlAddrstringOptional

Prize Receiving Address

Example: 아무건물 302호

deliTelNostringOptional

Prize Recipient Phone No.

Example: 021234567

deliTelRgnNostringOptional

Prize Recipient Phone Area Code

Example: 02

deliTelTxnoNostringOptional

Prize Recipient Phone Exchange No.

Example: 123

deliTelEndNostringOptional

Prize Recipient Phone Last Digits

Example: 4567

deliCellNostringOptional

Prize Recipient Mobile Phone No.

Example: 01011112222

deliCellSctNostringOptional

Prize Delivery Address Mobile Phone Prefix

Example: 010

deliCellTxnoNostringOptional

Prize Delivery Address Mobile Phone Middle Digits

Example: 1111

deliCellEndNostringOptional

Prize Delivery Address Mobile Phone Last Digits

Example: 2222

realGoodsstringOptional

Physical Prize

Example: 1002304

evtNmstringOptional

Event Name

Example: 이벤트

aempIdstringOptional

Event Manager

Example: 1002304

startDatestringOptional

Entry Period Start Date

endDatestringOptional

Entry Period End Date

excelHeaderstringOptional

Excel Header

winCnclDtmstring · date-timeOptional

Winning Cancellation Date/Time

winDtmstring · date-timeOptional

Winning Date/Time

myCertiDtmstring · date-timeOptional

Identity Verification Date/Time

sbscAplyDtmstring · date-timeOptional

Application Date/Time

wtpsSltDtmstring · date-timeOptional

Waitlist Selection Date/Time

tubaDptDtmstring · date-timeOptional

Tax Withholding Deposit Date/Time

buyStrDtmstring · date-timeOptional

Purchase Period Start Date/Time

buyEndDtmstring · date-timeOptional

Purchase Period End Date/Time

alarmStatusYnstringOptional

Notification Talk/Notification Usage Status

Example: Y

evtFvrTypCdstring · enumOptional

Event Benefit Type Code (EV011)

Example: 10Possible values:

sbscPsbMinOrdAmtnumberOptional

Minimum Order Payment Amount for Entry

Responses

200

Tax and Public Dues Confirmation Success

*/*

stringOptional

900

Tax and Public Dues Confirmation Failure

*/*

post/v1/marketing/eventMgmt/saveChargeAndTaxReqProcDtm

POST /api/bo/v1/marketing/eventMgmt/saveChargeAndTaxReqProcDtm HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1774

{
  "qryGbCd": "text",
  "indInfoQryCaus": "text",
  "trgmnSeq": 1,
  "evtTrgmnGbCd": "04",
  "mbrNo": 100000,
  "winRnk": 1,
  "winCnclCausCont": "주문취소하여구매금액미달",
  "evtNo": 15322,
  "waitRnk": 10,
  "intx": 500000,
  "citx": 30000,
  "ordSumAmt": 50000,
  "cfmOrdAmt": 40000,
  "evtSbscPathCd": 20,
  "tubaBankCd": 104,
  "tubaDepositorNm": "김아무개",
  "tubaVirActnNo": "11111-222-333-44",
  "tubaDptAmt": 50000,
  "deliHdcCd": 10,
  "deliInvNo": 1141212314,
  "mailSndCnt": 10,
  "bbcNo": 114,
  "lotCondSeq": 2,
  "mbrNoList": [
    10000000,
    10000001,
    10000002
  ],
  "mbrNm": "홍길동",
  "loginId": "abc",
  "cellNo": "01011112222",
  "cellSctNo": "010",
  "cellTxnoNo": 1111,
  "cellEndNo": 2222,
  "lotObjCd": 10,
  "lotExcpStafYn": "Y",
  "trgmnSeqList": [
    100,
    101,
    102,
    103
  ],
  "trgmnSeqArr": 100,
  "lotTargetNum": 100,
  "lotLimitNum": 50,
  "evtMgrpCd": 30,
  "buyAmt": 50000,
  "setType": 10,
  "lotType": "text",
  "sndMethCd": "01",
  "rcvmnNm": "김아무개",
  "deliZipNo": 12345,
  "deliZipAddr": "서울시 아무구 아무동 1번",
  "deliZipDtlAddr": "아무건물 302호",
  "deliTelNo": "021234567",
  "deliTelRgnNo": "02",
  "deliTelTxnoNo": 123,
  "deliTelEndNo": 4567,
  "deliCellNo": "01011112222",
  "deliCellSctNo": "010",
  "deliCellTxnoNo": 1111,
  "deliCellEndNo": 2222,
  "realGoods": 1002304,
  "evtNm": "이벤트",
  "aempId": 1002304,
  "startDate": "text",
  "endDate": "text",
  "excelHeader": "text",
  "winCnclDtm": "2026-01-01T00:00:00.000Z",
  "winDtm": "2026-01-01T00:00:00.000Z",
  "myCertiDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
  "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
  "tubaDptDtm": "2026-01-01T00:00:00.000Z",
  "buyStrDtm": "2026-01-01T00:00:00.000Z",
  "buyEndDtm": "2026-01-01T00:00:00.000Z",
  "alarmStatusYn": "Y",
  "evtFvrTypCd": 10,
  "sbscPsbMinOrdAmt": 1,
  "dataList": [
    {
      "evtFvrSeq": 1,
      "evtNo": 15322,
      "mbrNo": 1000000,
      "lotGb": "04",
      "trgmnSeq": 1,
      "loginId": "abde",
      "mbrNm": "김아무개",
      "mbrSexGb": "M",
      "mbrAge": 19,
      "cellNo": "01011112222"
    }
  ]
}

text

Tax and Public Dues Confirmation Cancellation Processing

post

Function Description

• Performs tax and public dues confirmation cancellation processing.

---

Detailed Description

• Event No. (evtNo), Applicant Sequence No. (trgmnSeq), Member No. (mbrNo) are required.

• Performs tax and public dues confirmation cancellation processing for the applicant of the event.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

qryGbCdstringOptional

Excel Download Reason Code

indInfoQryCausstringOptional

Excel Download Reason

trgmnSeqstringOptional

Target Sequence No.

Example: 1

evtTrgmnGbCdstring · enumOptional

Event Target Classification Code (EV012)

Example: 04Possible values:

mbrNostringOptional

Member No.

Example: 100000

winRnkstringOptional

Winning Rank

Example: 1

winCnclCausContstringOptional

Winning Cancellation Reason Content

Example: 주문취소하여구매금액미달

evtNostringOptional

Event No.

Example: 15322

waitRnkstringOptional

Waitlist Rank

Example: 10

intxstringOptional

Income Tax

Example: 500000

citxstringOptional

Local Income Tax

Example: 30000

ordSumAmtstringOptional

Total Order Amount

Example: 50000

cfmOrdAmtstringOptional

Confirmed Order Amount

Example: 40000

evtSbscPathCdstring · enumOptional

Event Application Channel Code (OM007)

Example: 20Possible values:

tubaBankCdstring · enumOptional

Tax and Public Dues Bank Code (OM026)

Example: 104Possible values:

tubaDepositorNmstringOptional

Tax Withholding Account Holder Name

Example: 김아무개

tubaVirActnNostringOptional

Tax Withholding Virtual Account No.

Example: 11111-222-333-44

tubaDptAmtstringOptional

Tax Withholding Deposit Amount

Example: 50000

deliHdcCdstring · enumOptional

Delivery Courier Company Code (LO005)

Example: 10Possible values:

deliInvNostringOptional

Delivery Tracking No.

Example: 1141212314

mailSndCntstringOptional

Email Send Count

Example: 10

bbcNostringOptional

Post Number

Example: 114

lotCondSeqstringOptional

Drawing Condition Sequence No.

Example: 2

mbrNoListstring[]Optional

Member No. List

Example: [10000000,10000001,10000002]

mbrNmstringOptional

Member Name

Example: 홍길동

loginIdstringOptional

Member ID

Example: abc

cellNostringOptional

Mobile Phone Number

Example: 01011112222

cellSctNostringOptional

Mobile Phone Prefix Code

Example: 010

cellTxnoNostringOptional

Mobile Phone Exchange Code

Example: 1111

cellEndNostringOptional

Mobile Phone Last Digits

Example: 2222

lotObjCdstring · enumOptional

Drawing Purpose (EV022)

Example: 10Possible values:

lotExcpStafYnstringOptional

Exclude Employees from Drawing Target Status

Example: Y

trgmnSeqListstring[]Optional

Entry No.

Example: [100,101,102,103]

trgmnSeqArrstringOptional

Entry No.

Example: 100

lotTargetNuminteger · int32Optional

Number of Drawing Targets

Example: 100

lotLimitNuminteger · int32Optional

Number of Winners by Prize Benefit

Example: 50

evtMgrpCdstring · enumOptional

Event Type (EV002)

Example: 30Possible values:

buyAmtinteger · int32Optional

Purchase Amount

Example: 50000

setTypestringOptional

Win & Win Cancellation

Example: 10

lotTypestringOptional

Drawing Type: Draw:LL, Redraw:RL, Add to Waitlist:WA, Waitlist Draw:WL, Waitlist Win Cancellation:WC, Waitlist Redraw:WR

sndMethCdstring · enumOptional

Send Method Code (EV013)

Example: 01Possible values:

rcvmnNmstringOptional

Prize Recipient Name

Example: 김아무개

deliZipNostringOptional

Prize Delivery Address Postal Code

Example: 12345

deliZipAddrstringOptional

Prize Receiving Address

Example: 서울시 아무구 아무동 1번

deliZipDtlAddrstringOptional

Prize Receiving Address

Example: 아무건물 302호

deliTelNostringOptional

Prize Recipient Phone No.

Example: 021234567

deliTelRgnNostringOptional

Prize Recipient Phone Area Code

Example: 02

deliTelTxnoNostringOptional

Prize Recipient Phone Exchange No.

Example: 123

deliTelEndNostringOptional

Prize Recipient Phone Last Digits

Example: 4567

deliCellNostringOptional

Prize Recipient Mobile Phone No.

Example: 01011112222

deliCellSctNostringOptional

Prize Delivery Address Mobile Phone Prefix

Example: 010

deliCellTxnoNostringOptional

Prize Delivery Address Mobile Phone Middle Digits

Example: 1111

deliCellEndNostringOptional

Prize Delivery Address Mobile Phone Last Digits

Example: 2222

realGoodsstringOptional

Physical Prize

Example: 1002304

evtNmstringOptional

Event Name

Example: 이벤트

aempIdstringOptional

Event Manager

Example: 1002304

startDatestringOptional

Entry Period Start Date

endDatestringOptional

Entry Period End Date

excelHeaderstringOptional

Excel Header

winCnclDtmstring · date-timeOptional

Winning Cancellation Date/Time

winDtmstring · date-timeOptional

Winning Date/Time

myCertiDtmstring · date-timeOptional

Identity Verification Date/Time

sbscAplyDtmstring · date-timeOptional

Application Date/Time

wtpsSltDtmstring · date-timeOptional

Waitlist Selection Date/Time

tubaDptDtmstring · date-timeOptional

Tax Withholding Deposit Date/Time

buyStrDtmstring · date-timeOptional

Purchase Period Start Date/Time

buyEndDtmstring · date-timeOptional

Purchase Period End Date/Time

alarmStatusYnstringOptional

Notification Talk/Notification Usage Status

Example: Y

evtFvrTypCdstring · enumOptional

Event Benefit Type Code (EV011)

Example: 10Possible values:

sbscPsbMinOrdAmtnumberOptional

Minimum Order Payment Amount for Entry

Responses

200

Tax and Public Dues Confirmation Cancellation Success

*/*

stringOptional

900

Tax and Public Dues Confirmation Cancellation Failure

*/*

post/v1/marketing/eventMgmt/saveChargeAndTaxReqProcDtmCancellation

POST /api/bo/v1/marketing/eventMgmt/saveChargeAndTaxReqProcDtmCancellation HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1774

{
  "qryGbCd": "text",
  "indInfoQryCaus": "text",
  "trgmnSeq": 1,
  "evtTrgmnGbCd": "04",
  "mbrNo": 100000,
  "winRnk": 1,
  "winCnclCausCont": "주문취소하여구매금액미달",
  "evtNo": 15322,
  "waitRnk": 10,
  "intx": 500000,
  "citx": 30000,
  "ordSumAmt": 50000,
  "cfmOrdAmt": 40000,
  "evtSbscPathCd": 20,
  "tubaBankCd": 104,
  "tubaDepositorNm": "김아무개",
  "tubaVirActnNo": "11111-222-333-44",
  "tubaDptAmt": 50000,
  "deliHdcCd": 10,
  "deliInvNo": 1141212314,
  "mailSndCnt": 10,
  "bbcNo": 114,
  "lotCondSeq": 2,
  "mbrNoList": [
    10000000,
    10000001,
    10000002
  ],
  "mbrNm": "홍길동",
  "loginId": "abc",
  "cellNo": "01011112222",
  "cellSctNo": "010",
  "cellTxnoNo": 1111,
  "cellEndNo": 2222,
  "lotObjCd": 10,
  "lotExcpStafYn": "Y",
  "trgmnSeqList": [
    100,
    101,
    102,
    103
  ],
  "trgmnSeqArr": 100,
  "lotTargetNum": 100,
  "lotLimitNum": 50,
  "evtMgrpCd": 30,
  "buyAmt": 50000,
  "setType": 10,
  "lotType": "text",
  "sndMethCd": "01",
  "rcvmnNm": "김아무개",
  "deliZipNo": 12345,
  "deliZipAddr": "서울시 아무구 아무동 1번",
  "deliZipDtlAddr": "아무건물 302호",
  "deliTelNo": "021234567",
  "deliTelRgnNo": "02",
  "deliTelTxnoNo": 123,
  "deliTelEndNo": 4567,
  "deliCellNo": "01011112222",
  "deliCellSctNo": "010",
  "deliCellTxnoNo": 1111,
  "deliCellEndNo": 2222,
  "realGoods": 1002304,
  "evtNm": "이벤트",
  "aempId": 1002304,
  "startDate": "text",
  "endDate": "text",
  "excelHeader": "text",
  "winCnclDtm": "2026-01-01T00:00:00.000Z",
  "winDtm": "2026-01-01T00:00:00.000Z",
  "myCertiDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
  "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
  "tubaDptDtm": "2026-01-01T00:00:00.000Z",
  "buyStrDtm": "2026-01-01T00:00:00.000Z",
  "buyEndDtm": "2026-01-01T00:00:00.000Z",
  "alarmStatusYn": "Y",
  "evtFvrTypCd": 10,
  "sbscPsbMinOrdAmt": 1,
  "dataList": [
    {
      "evtFvrSeq": 1,
      "evtNo": 15322,
      "mbrNo": 1000000,
      "lotGb": "04",
      "trgmnSeq": 1,
      "loginId": "abde",
      "mbrNm": "김아무개",
      "mbrSexGb": "M",
      "mbrAge": 19,
      "cellNo": "01011112222"
    }
  ]
}

text

Save Event Detail Information

post

Function Description

• Saves the event detail information.

---

Detailed Description

• Event No. (evtNo), all parameter values corresponding to the event type are required.

• Validation check values differ depending on the event type.

• Saves event basic information / detail items (attendance check, survey, etc.) / application information / benefit information / template information / display grade information

Revision History

• Release 2.00_240401: Added event validation

• Release v2.00_240425: Changed to receive and register applicable site information as a String List

• Release v2.00_240509: Changed to check tax and public dues input only when the reward is a physical prize when registering an event

• Release v2.00_240711: Changed the entry count check according to event type when registering an event

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

siteNostringOptional

Site No.

Example: 1

statestringOptional

Data Value State Status (U if data value exists / I if not)

Example: U

reSearchPagestringOptional

Parent Window Grid Search Type Value

periodGbstringOptional

Period Search Type: 0: Start Date, 1: End Date, 2: Drawing Date, 3: Send Date

Example: 0

startDatestring · dateOptional

Start Date

endDatestring · dateOptional

End Date

dateSelectstringOptional

Date Selection Option

Example: all_day

evtTypstringOptional

Event Type

argSelectTypestringOptional

Selection Type (1: Single, N: Multiple)

Example: 1

evtNmstring · min: 1Required

Event Name

Example: 단순클릭 이벤트

evtNostringOptional

Event No.

Example: 15322

uprFixYnstringOptional

Top Position Status

Example: Y

evtUrlAddrstringOptional

Event URL

Example: /event/15322

deptCdstring · min: 1Required

Managing Department Code

Example: 10130

aempIdstringOptional

Person in Charge ID

Example: abcd

dispYnstring · min: 1Required

Display Status

Example: Y

evtPrgsStatstring · enumOptional

Management Status (EV005)

Example: 01Possible values:

adveWrdContstringOptional

Event Promotional Copy

Example: 이벤트홍보

evtSchTagstringOptional

Search Tag

Example: 이벤트

expYnstringOptional

Event Display

Example: Y

mbrGbCdArrstring · enumOptional

Display Grade Type Code (ME002)

Possible values:

mbrGradeCdArrstring · enumOptional

Display Grade Type Code (ME008)

Example: 10Possible values:

evtSbscPsbCdstring · enumOptional

Event Entry Eligibility Code (EV006)

Example: 01Possible values:

evtExpNmCdstring · enumOptional

Event Display Name Code (EV003)

Example: 01Possible values:

indInfoMkusAgrYnstringOptional

Personal Information Usage Consent Status

Example: N

indInfoMkusAgmtstringOptional

Personal Information Usage Terms

indInfoThprPofAgrYnstringOptional

Personal Information Third-Party Provision Consent Status

Example: N

indInfoThprPofAgmtstringOptional

Personal Information Third-Party Provision Terms

evtLgrpCdstring · enum · min: 1Required

Event Type Major Category Code (EV001)

Example: 20Possible values:

evtMgrpCdstring · enum · min: 1Required

Event Type Subcategory Code (EV002)

Example: 30Possible values:

mbrGradeCd2string · enumOptional

Applicant Member Grade (ME008)

Example: 10Possible values:

evtGbCdstring · enumOptional

Event Type Code (EV026)

Example: 01Possible values:

sbscCntLmtCdstring · enum · min: 1Required

Number of Entries (EV007)

Example: 02Possible values:

evtObjCdstring · enum · min: 1Required

Event Purpose (EV004)

Example: 01Possible values:

purAmtEvtPromoYnstringOptional

Purchase Amount Event Promotion Status

Example: N

lotDtstringOptional

Drawing/Confirmation Date

winAncmDtstringOptional

Winner Announcement Date/Time

winAncmDispYnstringOptional

Winner Announcement Display

Example: Y

payDtstringOptional

Point Payout Date/Time

pmgdSndDtstringOptional

Gift Shipment Date

evtBnrPathNmstring · min: 1Required

Event Banner Path

Example: files/test/../../test.png

evtBnrFileNmstring · min: 1Required

Event Banner File Name

Example: test.png

evtBnrAltContstringOptional

Event Banner Alt Text

Example: 배너이미지 대체 텍스트

pcEvtBnrPathNmstring · min: 1Required

Event Banner Path Name (PC)

Example: files/test/../../test.png

pcEvtBnrFileNmstring · min: 1Required

Event Banner File Name (PC)

Example: test.png

pcEvtBnrAltContstringOptional

Event Banner Alt Text for PC

Example: 배너이미지 PC용 대체 텍스트

aplySitesstring[]Optional

Insert Site Information (String)

rnkMgrYnstringOptional

Ranking Management Status

Example: N

winWtpsCntstringOptional

Number of Winners on Waitlist

Example: 100

pmgdRcvProeContstringOptional

Prize Receiving Procedure Content

Example: 경품수령절차내용

evetTermDescstringOptional

Event Period Description

Example: 행사기간설명

evetCondDescstringOptional

Event Condition Description

Example: 행사조건설명

paysTermDescstringOptional

Payout Period Description

Example: 지급기간설명

evtTmplUseYnstringOptional

Event Template Usage Status

Example: Y

tmplUseGbstringOptional

Template Selection Template No.

tmplDtlCmpsCdArrstring · enumOptional

Template Detail Classification Code (EV014)

Example: 10Possible values:

htmlFileContstringOptional

Template Content

pcHtmlFileContstringOptional

Template Content for PC

evtExpMsgstringOptional

Event Display Message

Example: 이벤트 노출 메시지

atndMtrstringOptional

Precautions

Example: 유의사항

acdnUseYnstringOptional

Accordion UI Usage Status

Example: Y

custCntrGdWrdContstringOptional

Customer Center Guide Message Content

Example: 고객센터안내문구내용

evtNoListstring[]Optional

Event No. Array

Example: [15692,15652,15562,15382]

evtStrDtmstring · date-timeRequired

Event Period Start Date

evtEndDtmstring · date-timeRequired

Event Period End Date

buyStrDtmstring · date-timeOptional

Purchase Period Start Date

buyEndDtmstring · date-timeOptional

Purchase Period End Date

sbscAplyStrDtmstring · date-timeRequired

Application Period Start Date

sbscAplyEndDtmstring · date-timeRequired

Application Period End Date

tubaDptStrDtstring · date-timeOptional

Withholding Tax Deposit Start Date/Time

tubaDptEndDtstring · date-timeOptional

Withholding Tax Deposit End Date/Time

sbscPsbMinOrdAmtinteger · int64Optional

Minimum Order Payment Amount

Responses

200

Detail Information Save Success

*/*

stringOptional

900

Detail Information Save Failure

*/*

post/v1/marketing/eventMgmt/saveCcEvtBase

POST /api/bo/v1/marketing/eventMgmt/saveCcEvtBase HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2910

{
  "siteNo": 1,
  "state": "U",
  "reSearchPage": "text",
  "periodGb": 0,
  "startDate": "2026-01-01",
  "endDate": "2026-01-01",
  "dateSelect": "all_day",
  "evtTyp": "text",
  "argSelectType": 1,
  "evtNm": "단순클릭 이벤트",
  "evtNo": 15322,
  "uprFixYn": "Y",
  "evtUrlAddr": "/event/15322",
  "deptCd": 10130,
  "aempId": "abcd",
  "dispYn": "Y",
  "evtPrgsStat": "01",
  "adveWrdCont": "이벤트홍보",
  "evtSchTag": "이벤트",
  "expYn": "Y",
  "mbrGbCdArr": "UNION_MEMBER",
  "mbrGradeCdArr": 10,
  "evtSbscPsbCd": "01",
  "evtExpNmCd": "01",
  "indInfoMkusAgrYn": "N",
  "indInfoMkusAgmt": "text",
  "indInfoThprPofAgrYn": "N",
  "indInfoThprPofAgmt": "text",
  "evtLgrpCd": 20,
  "evtMgrpCd": 30,
  "mbrGradeCd2": 10,
  "evtGbCd": "01",
  "sbscCntLmtCd": "02",
  "evtObjCd": "01",
  "purAmtEvtPromoYn": "N",
  "lotDt": "text",
  "winAncmDt": "text",
  "winAncmDispYn": "Y",
  "payDt": "text",
  "pmgdSndDt": "text",
  "evtBnrPathNm": "files/test/../../test.png",
  "evtBnrFileNm": "test.png",
  "evtBnrAltCont": "배너이미지 대체 텍스트",
  "pcEvtBnrPathNm": "files/test/../../test.png",
  "pcEvtBnrFileNm": "test.png",
  "pcEvtBnrAltCont": "배너이미지 PC용 대체 텍스트",
  "loltList": [
    {
      "evtNo": 15322,
      "evtMgrpCd": 30,
      "aplyRnk": 1,
      "roltPayPnum": 100,
      "roltPrbl": 10,
      "payPoint": 200
    }
  ],
  "attenList": [
    {
      "evtNo": 15322,
      "evtMgrpCd": 30,
      "aplyRnk": 1,
      "roltPayPnum": 100,
      "roltPrbl": 10,
      "payPoint": 200
    }
  ],
  "questList": [
    {
      "evtNo": 15322,
      "questNo": 1,
      "questGbCd": 20,
      "questCont": "이것은 사과입니까?",
      "questQestCnt": 4,
      "cawrCont": "네",
      "dupAnsYn": "Y",
      "mdtyQuestYn": "Y",
      "questExpltList": [
        {
          "evtNo": 15322,
          "questNo": 1,
          "questExplNo": 3,
          "questExplCont": "네",
          "questBnrPathNm": "files/test/../../test.png",
          "questBnrFileNm": "test.png"
        }
      ]
    }
  ],
  "pmgdList": [
    {
      "evtNo": 15322,
      "evtFvrSeq": 1,
      "winRnk": 1,
      "evtFvrTypCd": 10,
      "buyAmt": 50000,
      "payMilg": 50000,
      "evtGoodsNm": "테스트상품",
      "promoNo": 1000000,
      "goodsNo": 1000000,
      "payPnumCnt": 100,
      "pmgdAmt": 10000,
      "winmnChrgYn": "Y",
      "tuba": 2000,
      "winWtpsCnt": 100,
      "payAmt": 100000,
      "etcDesc1": "설명1",
      "etcDesc2": "설명2",
      "etcDesc3": "설명3",
      "etcDesc4": "설명4",
      "etcDesc5": "설명5"
    }
  ],
  "aplyList": [
    {
      "evtNo": "text",
      "custFvrAplyGbCd": 10,
      "custFvrAplyTypCd": 10,
      "fvrTgtNo": "text",
      "siteNm": "text",
      "siteDom": "text",
      "applyCont": "text"
    }
  ],
  "aplySites": [
    "text"
  ],
  "rnkMgrYn": "N",
  "winWtpsCnt": 100,
  "pmgdRcvProeCont": "경품수령절차내용",
  "evetTermDesc": "행사기간설명",
  "evetCondDesc": "행사조건설명",
  "paysTermDesc": "지급기간설명",
  "evtTmplUseYn": "Y",
  "tmplUseGb": "text",
  "tmplDtlCmpsCdArr": 10,
  "htmlFileCont": "text",
  "pcHtmlFileCont": "text",
  "evtExpMsg": "이벤트 노출 메시지",
  "atndMtr": "유의사항",
  "acdnUseYn": "Y",
  "custCntrGdWrdCont": "고객센터안내문구내용",
  "evtNoList": [
    15692,
    15652,
    15562,
    15382
  ],
  "evtStrDtm": "2026-01-01T00:00:00.000Z",
  "evtEndDtm": "2026-01-01T00:00:00.000Z",
  "buyStrDtm": "2026-01-01T00:00:00.000Z",
  "buyEndDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
  "tubaDptStrDt": "2026-01-01T00:00:00.000Z",
  "tubaDptEndDt": "2026-01-01T00:00:00.000Z",
  "sbscPsbMinOrdAmt": 1
}

text

Search Members for Bulk Registration in Event Entry Management

post

Function Description

• Searches for members for bulk registration in Event Entry Management.

---

Detailed Description

• Event No. (evtNO), Member No. (mbrNo) are required.

• Performs a bulk member search to verify member information entered in Excel.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Bodyobject · CcEvtTrgmnInfoRequest[]

qryGbCdstringOptional

Excel Download Reason Code

indInfoQryCausstringOptional

Excel Download Reason

trgmnSeqstringOptional

Target Sequence No.

Example: 1

evtTrgmnGbCdstring · enumOptional

Event Target Classification Code (EV012)

Example: 04Possible values:

mbrNostringOptional

Member No.

Example: 100000

winRnkstringOptional

Winning Rank

Example: 1

winCnclCausContstringOptional

Winning Cancellation Reason Content

Example: 주문취소하여구매금액미달

evtNostringOptional

Event No.

Example: 15322

waitRnkstringOptional

Waitlist Rank

Example: 10

intxstringOptional

Income Tax

Example: 500000

citxstringOptional

Local Income Tax

Example: 30000

ordSumAmtstringOptional

Total Order Amount

Example: 50000

cfmOrdAmtstringOptional

Confirmed Order Amount

Example: 40000

evtSbscPathCdstring · enumOptional

Event Application Channel Code (OM007)

Example: 20Possible values:

tubaBankCdstring · enumOptional

Tax and Public Dues Bank Code (OM026)

Example: 104Possible values:

tubaDepositorNmstringOptional

Tax Withholding Account Holder Name

Example: 김아무개

tubaVirActnNostringOptional

Tax Withholding Virtual Account No.

Example: 11111-222-333-44

tubaDptAmtstringOptional

Tax Withholding Deposit Amount

Example: 50000

deliHdcCdstring · enumOptional

Delivery Courier Company Code (LO005)

Example: 10Possible values:

deliInvNostringOptional

Delivery Tracking No.

Example: 1141212314

mailSndCntstringOptional

Email Send Count

Example: 10

bbcNostringOptional

Post Number

Example: 114

lotCondSeqstringOptional

Drawing Condition Sequence No.

Example: 2

mbrNoListstring[]Optional

Member No. List

Example: [10000000,10000001,10000002]

mbrNmstringOptional

Member Name

Example: 홍길동

loginIdstringOptional

Member ID

Example: abc

cellNostringOptional

Mobile Phone Number

Example: 01011112222

cellSctNostringOptional

Mobile Phone Prefix Code

Example: 010

cellTxnoNostringOptional

Mobile Phone Exchange Code

Example: 1111

cellEndNostringOptional

Mobile Phone Last Digits

Example: 2222

lotObjCdstring · enumOptional

Drawing Purpose (EV022)

Example: 10Possible values:

lotExcpStafYnstringOptional

Exclude Employees from Drawing Target Status

Example: Y

trgmnSeqListstring[]Optional

Entry No.

Example: [100,101,102,103]

trgmnSeqArrstringOptional

Entry No.

Example: 100

lotTargetNuminteger · int32Optional

Number of Drawing Targets

Example: 100

lotLimitNuminteger · int32Optional

Number of Winners by Prize Benefit

Example: 50

evtMgrpCdstring · enumOptional

Event Type (EV002)

Example: 30Possible values:

buyAmtinteger · int32Optional

Purchase Amount

Example: 50000

setTypestringOptional

Win & Win Cancellation

Example: 10

lotTypestringOptional

Drawing Type: Draw:LL, Redraw:RL, Add to Waitlist:WA, Waitlist Draw:WL, Waitlist Win Cancellation:WC, Waitlist Redraw:WR

sndMethCdstring · enumOptional

Send Method Code (EV013)

Example: 01Possible values:

rcvmnNmstringOptional

Prize Recipient Name

Example: 김아무개

deliZipNostringOptional

Prize Delivery Address Postal Code

Example: 12345

deliZipAddrstringOptional

Prize Receiving Address

Example: 서울시 아무구 아무동 1번

deliZipDtlAddrstringOptional

Prize Receiving Address

Example: 아무건물 302호

deliTelNostringOptional

Prize Recipient Phone No.

Example: 021234567

deliTelRgnNostringOptional

Prize Recipient Phone Area Code

Example: 02

deliTelTxnoNostringOptional

Prize Recipient Phone Exchange No.

Example: 123

deliTelEndNostringOptional

Prize Recipient Phone Last Digits

Example: 4567

deliCellNostringOptional

Prize Recipient Mobile Phone No.

Example: 01011112222

deliCellSctNostringOptional

Prize Delivery Address Mobile Phone Prefix

Example: 010

deliCellTxnoNostringOptional

Prize Delivery Address Mobile Phone Middle Digits

Example: 1111

deliCellEndNostringOptional

Prize Delivery Address Mobile Phone Last Digits

Example: 2222

realGoodsstringOptional

Physical Prize

Example: 1002304

evtNmstringOptional

Event Name

Example: 이벤트

aempIdstringOptional

Event Manager

Example: 1002304

startDatestringOptional

Entry Period Start Date

endDatestringOptional

Entry Period End Date

excelHeaderstringOptional

Excel Header

winCnclDtmstring · date-timeOptional

Winning Cancellation Date/Time

winDtmstring · date-timeOptional

Winning Date/Time

myCertiDtmstring · date-timeOptional

Identity Verification Date/Time

sbscAplyDtmstring · date-timeOptional

Application Date/Time

wtpsSltDtmstring · date-timeOptional

Waitlist Selection Date/Time

tubaDptDtmstring · date-timeOptional

Tax Withholding Deposit Date/Time

buyStrDtmstring · date-timeOptional

Purchase Period Start Date/Time

buyEndDtmstring · date-timeOptional

Purchase Period End Date/Time

alarmStatusYnstringOptional

Notification Talk/Notification Usage Status

Example: Y

evtFvrTypCdstring · enumOptional

Event Benefit Type Code (EV011)

Example: 10Possible values:

sbscPsbMinOrdAmtnumberOptional

Minimum Order Payment Amount for Entry

Responses

200

Member Retrieved Successfully

*/*

qryGbCdstringOptional

Personal Information Access Type Code (UR014) 10: View, 20: Excel Download, 30: Modify

Example: 20

indInfoQryCausstringOptional

Access Reason Content

Example: 환불처리작업

evtMgrpCdstring · enumOptional

Event Type Subcategory Code (EV002)

Example: 30Possible values:

trgmnSeqstringOptional

Target Sequence No.

evtFvrTypCdstring · enumOptional

Event Benefit Type Code (EV011)

Example: 10Possible values:

evtTrgmnGbCdstring · enumOptional

Event Target Classification Code (EV012)

Example: 04Possible values:

mbrNostringOptional

Member No.

winRnkinteger · int32Optional

Winning Rank

winCnclCausContstringOptional

Winning Cancellation Reason Content

evtNostringOptional

Event No.

waitRnkinteger · int32Optional

Waitlist Rank

intxinteger · int32Optional

Income Tax

citxinteger · int32Optional

Local Income Tax

ordSumAmtinteger · int32Optional

Total Order Amount

cfmOrdAmtnumberOptional

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.

tubaDptAmtnumberOptional

Tax Withholding Deposit Amount

deliHdcCdstring · enumOptional

Delivery Courier Company Code (LO005)

Example: 10Possible values:

deliInvNostringOptional

Delivery Tracking No.

mailSndCntinteger · int32Optional

Email Send Count

mailSndFailCntinteger · int32Optional

Email Send Failure Count

bbcNostringOptional

Post Number

lotCondSeqstringOptional

Drawing Condition Sequence No.

etcGftDlvpNostringOptional

Other Gift Delivery Address No.

paysYnstringOptional

Payment Status

mbrNmstringOptional

Member Name

loginIdstringOptional

Member ID

emailAddrstringOptional

Email

zipAddrstringOptional

Address

dtlAddrstringOptional

Detailed Address

cellNostringOptional

Full Mobile Phone Number

cellSctNostringOptional

Mobile Phone Prefix Code

cellTxnoNostringOptional

Mobile Phone Exchange Code

cellEndNostringOptional

Mobile Phone Last Digits

errorMessagestringOptional

Error Message

lotStatstringOptional

Winning Status

lotGbstringOptional

Winner Classification

waitGbstringOptional

Waitlist Type

realGoodsstringOptional

Physical Prize

realGoodsNmstringOptional

Physical Prize Name

pmgdSndDtstringOptional

Prize Dispatch Date

payDtstringOptional

Payment Date (Mileage/Coupon)

payMilgnumberOptional

Mileage

payPointstringOptional

Points

rcvmnNmstringOptional

Prize Recipient Name

deliZipNostringOptional

Prize Delivery Address Postal Code

deliZipAddrstringOptional

Prize Receiving Address

deliZipDtlAddrstringOptional

Prize Receiving Address

deliCellSctNostringOptional

Prize Delivery Address Mobile Phone Prefix

deliCellTxnoNostringOptional

Prize Delivery Address Mobile Phone Middle Digits

deliCellEndNostringOptional

Prize Delivery Address Mobile Phone Last Digits

pmgdAmtstringOptional

Prize Value

realPointstringOptional

Actual Points Paid

resndYnstringOptional

Resend Status

evtNmstringOptional

Event Name

aempIdstringOptional

Event Manager

aempNmstringOptional

Event Manager

startDatestringOptional

Entry Period Start Date

endDatestringOptional

Entry Period End Date

mbrSexGbstringOptional

Gender

mbrAgestringOptional

Age

buyAmtinteger · int64Optional

Purchase Amount

bbcContstringOptional

Comment Content

excpTrgmnYnstringOptional

Event Excluded Target Status

lgcMbrNostringOptional

Core System Member No.

deliMsgstringOptional

Delivery Message

comnFrdrEtcMethodstringOptional

Building Entrance Other Access Method

comnFrdrPwdstringOptional

Building Entrance Password

realCouponNmstringOptional

Coupon Name

trnsYnstringOptional

Transmission Status

evtFvrSeqstringOptional

Event Benefit Sequence No.

winmnChrgYnstringOptional

Winner Cost-Bearing Status

tubanumberOptional

Withholding Tax

promoNostringOptional

Coupon No.

mbrGradeCdstringOptional

Member Grade Code

tubaEnterYnstringOptional

Tax and Public Dues Payment Status

goodsGiftsNmstringOptional

Gift Item

changePossibleYnstringOptional

Changeable Status

arrSndMethCdstringOptional

Sending Method Type Code

arrSndMethNmstringOptional

Sending Method Type Code

sbscAplyDtmstring · date-timeOptional

Application Date/Time

wtpsSltDtmstring · date-timeOptional

Waitlist Selection Date/Time

winDtmstring · date-timeOptional

Winning Date/Time

winCnclDtmstring · date-timeOptional

Winning Cancellation Date/Time

myCertiDtmstring · date-timeOptional

Identity Verification Date/Time

tubaDptDtmstring · date-timeOptional

Tax Withholding Deposit Date/Time

buyDtmstring · date-timeOptional

Purchase Date and Time

paysDtmstring · date-timeOptional

Payment Date/Time

buyStrDtmstring · date-timeOptional

Purchase Period Start Date/Time

buyEndDtmstring · date-timeOptional

Purchase Period End Date/Time

sbscPsbMinOrdAmtnumberOptional

Minimum Order Payment Amount for Entry

stafYnstringOptional

Employee Status

lotTypestringOptional

Request Type

mbrYnstringOptional

Member Existence Status

lotYnstringOptional

Winning Status

900

Member Retrieval Failed

*/*

post/v1/marketing/eventMgmt/getEventMgmtMemberCheckList

POST /api/bo/v1/marketing/eventMgmt/getEventMgmtMemberCheckList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1776

[
  {
    "qryGbCd": "text",
    "indInfoQryCaus": "text",
    "trgmnSeq": 1,
    "evtTrgmnGbCd": "04",
    "mbrNo": 100000,
    "winRnk": 1,
    "winCnclCausCont": "주문취소하여구매금액미달",
    "evtNo": 15322,
    "waitRnk": 10,
    "intx": 500000,
    "citx": 30000,
    "ordSumAmt": 50000,
    "cfmOrdAmt": 40000,
    "evtSbscPathCd": 20,
    "tubaBankCd": 104,
    "tubaDepositorNm": "김아무개",
    "tubaVirActnNo": "11111-222-333-44",
    "tubaDptAmt": 50000,
    "deliHdcCd": 10,
    "deliInvNo": 1141212314,
    "mailSndCnt": 10,
    "bbcNo": 114,
    "lotCondSeq": 2,
    "mbrNoList": [
      10000000,
      10000001,
      10000002
    ],
    "mbrNm": "홍길동",
    "loginId": "abc",
    "cellNo": "01011112222",
    "cellSctNo": "010",
    "cellTxnoNo": 1111,
    "cellEndNo": 2222,
    "lotObjCd": 10,
    "lotExcpStafYn": "Y",
    "trgmnSeqList": [
      100,
      101,
      102,
      103
    ],
    "trgmnSeqArr": 100,
    "lotTargetNum": 100,
    "lotLimitNum": 50,
    "evtMgrpCd": 30,
    "buyAmt": 50000,
    "setType": 10,
    "lotType": "text",
    "sndMethCd": "01",
    "rcvmnNm": "김아무개",
    "deliZipNo": 12345,
    "deliZipAddr": "서울시 아무구 아무동 1번",
    "deliZipDtlAddr": "아무건물 302호",
    "deliTelNo": "021234567",
    "deliTelRgnNo": "02",
    "deliTelTxnoNo": 123,
    "deliTelEndNo": 4567,
    "deliCellNo": "01011112222",
    "deliCellSctNo": "010",
    "deliCellTxnoNo": 1111,
    "deliCellEndNo": 2222,
    "realGoods": 1002304,
    "evtNm": "이벤트",
    "aempId": 1002304,
    "startDate": "text",
    "endDate": "text",
    "excelHeader": "text",
    "winCnclDtm": "2026-01-01T00:00:00.000Z",
    "winDtm": "2026-01-01T00:00:00.000Z",
    "myCertiDtm": "2026-01-01T00:00:00.000Z",
    "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
    "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
    "tubaDptDtm": "2026-01-01T00:00:00.000Z",
    "buyStrDtm": "2026-01-01T00:00:00.000Z",
    "buyEndDtm": "2026-01-01T00:00:00.000Z",
    "alarmStatusYn": "Y",
    "evtFvrTypCd": 10,
    "sbscPsbMinOrdAmt": 1,
    "dataList": [
      {
        "evtFvrSeq": 1,
        "evtNo": 15322,
        "mbrNo": 1000000,
        "lotGb": "04",
        "trgmnSeq": 1,
        "loginId": "abde",
        "mbrNm": "김아무개",
        "mbrSexGb": "M",
        "mbrAge": 19,
        "cellNo": "01011112222"
      }
    ]
  }
]

[
  {
    "qryGbCd": 20,
    "indInfoQryCaus": "환불처리작업",
    "evtMgrpCd": 30,
    "trgmnSeq": "text",
    "evtFvrTypCd": 10,
    "evtTrgmnGbCd": "04",
    "mbrNo": "text",
    "winRnk": 1,
    "winCnclCausCont": "text",
    "evtNo": "text",
    "waitRnk": 1,
    "intx": 1,
    "citx": 1,
    "ordSumAmt": 1,
    "cfmOrdAmt": 1,
    "evtSbscPathCd": "text",
    "tubaBankCd": "text",
    "tubaDepositorNm": "text",
    "tubaVirActnNo": "text",
    "tubaDptAmt": 1,
    "deliHdcCd": 10,
    "deliInvNo": "text",
    "mailSndCnt": 1,
    "mailSndFailCnt": 1,
    "bbcNo": "text",
    "lotCondSeq": "text",
    "etcGftDlvpNo": "text",
    "paysYn": "text",
    "mbrNm": "text",
    "loginId": "text",
    "emailAddr": "text",
    "zipAddr": "text",
    "dtlAddr": "text",
    "cellNo": "text",
    "cellSctNo": "text",
    "cellTxnoNo": "text",
    "cellEndNo": "text",
    "errorMessage": "text",
    "lotStat": "text",
    "lotGb": "text",
    "waitGb": "text",
    "realGoods": "text",
    "realGoodsNm": "text",
    "pmgdSndDt": "text",
    "payDt": "text",
    "payMilg": 1,
    "payPoint": "text",
    "rcvmnNm": "text",
    "deliZipNo": "text",
    "deliZipAddr": "text",
    "deliZipDtlAddr": "text",
    "deliCellSctNo": "text",
    "deliCellTxnoNo": "text",
    "deliCellEndNo": "text",
    "pmgdAmt": "text",
    "realPoint": "text",
    "resndYn": "text",
    "evtNm": "text",
    "aempId": "text",
    "aempNm": "text",
    "startDate": "text",
    "endDate": "text",
    "mbrSexGb": "text",
    "mbrAge": "text",
    "buyAmt": 1,
    "bbcCont": "text",
    "excpTrgmnYn": "text",
    "lgcMbrNo": "text",
    "deliMsg": "text",
    "comnFrdrEtcMethod": "text",
    "comnFrdrPwd": "text",
    "realCouponNm": "text",
    "trnsYn": "text",
    "evtFvrSeq": "text",
    "winmnChrgYn": "text",
    "tuba": 1,
    "promoNo": "text",
    "mbrGradeCd": "text",
    "tubaEnterYn": "text",
    "goodsGiftsNm": "text",
    "changePossibleYn": "text",
    "arrSndMethCd": "text",
    "arrSndMethNm": "text",
    "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
    "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
    "winDtm": "2026-01-01T00:00:00.000Z",
    "winCnclDtm": "2026-01-01T00:00:00.000Z",
    "myCertiDtm": "2026-01-01T00:00:00.000Z",
    "tubaDptDtm": "2026-01-01T00:00:00.000Z",
    "buyDtm": "2026-01-01T00:00:00.000Z",
    "paysDtm": "2026-01-01T00:00:00.000Z",
    "buyStrDtm": "2026-01-01T00:00:00.000Z",
    "buyEndDtm": "2026-01-01T00:00:00.000Z",
    "sbscPsbMinOrdAmt": 1,
    "stafYn": "text",
    "lotType": "text",
    "mbrYn": "text",
    "lotYn": "text"
  }
]

Retrieve Event Detail Information

post

Function Description

• Retrieves the event detail information.

---

Detailed Description

• Event No. (evtNo) is required.

• Retrieves the detail information of the event via the evtNo parameter.

• Retrieves display grade information, prize information, template information, survey information, attendance check information, etc.

Revision History

• Release v2.00_240425: Added retrieval of applicable site list

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

siteNostringOptional

Site No.

Example: 1

statestringOptional

Data Value State Status (U if data value exists / I if not)

Example: U

reSearchPagestringOptional

Parent Window Grid Search Type Value

periodGbstringOptional

Period Search Type: 0: Start Date, 1: End Date, 2: Drawing Date, 3: Send Date

Example: 0

startDatestring · dateOptional

Start Date

endDatestring · dateOptional

End Date

dateSelectstringOptional

Date Selection Option

Example: all_day

evtTypstringOptional

Event Type

argSelectTypestringOptional

Selection Type (1: Single, N: Multiple)

Example: 1

evtNmstring · min: 1Required

Event Name

Example: 단순클릭 이벤트

evtNostringOptional

Event No.

Example: 15322

uprFixYnstringOptional

Top Position Status

Example: Y

evtUrlAddrstringOptional

Event URL

Example: /event/15322

deptCdstring · min: 1Required

Managing Department Code

Example: 10130

aempIdstringOptional

Person in Charge ID

Example: abcd

dispYnstring · min: 1Required

Display Status

Example: Y

evtPrgsStatstring · enumOptional

Management Status (EV005)

Example: 01Possible values:

adveWrdContstringOptional

Event Promotional Copy

Example: 이벤트홍보

evtSchTagstringOptional

Search Tag

Example: 이벤트

expYnstringOptional

Event Display

Example: Y

mbrGbCdArrstring · enumOptional

Display Grade Type Code (ME002)

Possible values:

mbrGradeCdArrstring · enumOptional

Display Grade Type Code (ME008)

Example: 10Possible values:

evtSbscPsbCdstring · enumOptional

Event Entry Eligibility Code (EV006)

Example: 01Possible values:

evtExpNmCdstring · enumOptional

Event Display Name Code (EV003)

Example: 01Possible values:

indInfoMkusAgrYnstringOptional

Personal Information Usage Consent Status

Example: N

indInfoMkusAgmtstringOptional

Personal Information Usage Terms

indInfoThprPofAgrYnstringOptional

Personal Information Third-Party Provision Consent Status

Example: N

indInfoThprPofAgmtstringOptional

Personal Information Third-Party Provision Terms

evtLgrpCdstring · enum · min: 1Required

Event Type Major Category Code (EV001)

Example: 20Possible values:

evtMgrpCdstring · enum · min: 1Required

Event Type Subcategory Code (EV002)

Example: 30Possible values:

mbrGradeCd2string · enumOptional

Applicant Member Grade (ME008)

Example: 10Possible values:

evtGbCdstring · enumOptional

Event Type Code (EV026)

Example: 01Possible values:

sbscCntLmtCdstring · enum · min: 1Required

Number of Entries (EV007)

Example: 02Possible values:

evtObjCdstring · enum · min: 1Required

Event Purpose (EV004)

Example: 01Possible values:

purAmtEvtPromoYnstringOptional

Purchase Amount Event Promotion Status

Example: N

lotDtstringOptional

Drawing/Confirmation Date

winAncmDtstringOptional

Winner Announcement Date/Time

winAncmDispYnstringOptional

Winner Announcement Display

Example: Y

payDtstringOptional

Point Payout Date/Time

pmgdSndDtstringOptional

Gift Shipment Date

evtBnrPathNmstring · min: 1Required

Event Banner Path

Example: files/test/../../test.png

evtBnrFileNmstring · min: 1Required

Event Banner File Name

Example: test.png

evtBnrAltContstringOptional

Event Banner Alt Text

Example: 배너이미지 대체 텍스트

pcEvtBnrPathNmstring · min: 1Required

Event Banner Path Name (PC)

Example: files/test/../../test.png

pcEvtBnrFileNmstring · min: 1Required

Event Banner File Name (PC)

Example: test.png

pcEvtBnrAltContstringOptional

Event Banner Alt Text for PC

Example: 배너이미지 PC용 대체 텍스트

aplySitesstring[]Optional

Insert Site Information (String)

rnkMgrYnstringOptional

Ranking Management Status

Example: N

winWtpsCntstringOptional

Number of Winners on Waitlist

Example: 100

pmgdRcvProeContstringOptional

Prize Receiving Procedure Content

Example: 경품수령절차내용

evetTermDescstringOptional

Event Period Description

Example: 행사기간설명

evetCondDescstringOptional

Event Condition Description

Example: 행사조건설명

paysTermDescstringOptional

Payout Period Description

Example: 지급기간설명

evtTmplUseYnstringOptional

Event Template Usage Status

Example: Y

tmplUseGbstringOptional

Template Selection Template No.

tmplDtlCmpsCdArrstring · enumOptional

Template Detail Classification Code (EV014)

Example: 10Possible values:

htmlFileContstringOptional

Template Content

pcHtmlFileContstringOptional

Template Content for PC

evtExpMsgstringOptional

Event Display Message

Example: 이벤트 노출 메시지

atndMtrstringOptional

Precautions

Example: 유의사항

acdnUseYnstringOptional

Accordion UI Usage Status

Example: Y

custCntrGdWrdContstringOptional

Customer Center Guide Message Content

Example: 고객센터안내문구내용

evtNoListstring[]Optional

Event No. Array

Example: [15692,15652,15562,15382]

evtStrDtmstring · date-timeRequired

Event Period Start Date

evtEndDtmstring · date-timeRequired

Event Period End Date

buyStrDtmstring · date-timeOptional

Purchase Period Start Date

buyEndDtmstring · date-timeOptional

Purchase Period End Date

sbscAplyStrDtmstring · date-timeRequired

Application Period Start Date

sbscAplyEndDtmstring · date-timeRequired

Application Period End Date

tubaDptStrDtstring · date-timeOptional

Withholding Tax Deposit Start Date/Time

tubaDptEndDtstring · date-timeOptional

Withholding Tax Deposit End Date/Time

sbscPsbMinOrdAmtinteger · int64Optional

Minimum Order Payment Amount

Responses

200

Detail Retrieval Success

*/*

reSearchPagestringOptional

Parent Window Grid Search Type Value

mbrNostringOptional

Member No.

mbrIdstringOptional

Member ID

mbrNmstringOptional

Member Name

mbrEmailstringOptional

Member Email

mbrAddrstringOptional

Member Address

mbrTelinteger · int32Optional

Member Phone Number

evtTypNmstringOptional

Event Type Name

evtNostringOptional

Event No.

evtNmstringOptional

Event Name

uprFixYnstringOptional

Top Position Status

evtLgrpCdstring · enumOptional

Event Type Major Category Code (EV001)

Example: 20Possible values:

evtMgrpCdstring · enumOptional

Event Type Subcategory Code (EV002)

Example: 30Possible values:

evtExpNmCdstring · enumOptional

Event Display Name Code (EV003)

Example: 01Possible values:

evtObjCdstring · enumOptional

Event Purpose (EV004)

Example: 01Possible values:

evtSbscPsbCdstring · enumOptional

Event Entry Eligibility Code (EV006)

Example: 01Possible values:

evtGbCdstring · enumOptional

Event Type Code (EV026)

Example: 01Possible values:

sbscCntLmtCdstring · enumOptional

Number of Entries (EV007)

Example: 02Possible values:

deptCdstringOptional

Managing Department Code

deptNmstringOptional

Organizing Department Name

evtPrgsStatCdstring · enumOptional

Event Progress Status Code (EV005)

Example: 01Possible values:

purAmtEvtPromoYnstringOptional

Purchase Amount Event Promotion Status

evetTermDescstringOptional

Event Period Description

evetCondDescstringOptional

Event Condition Description

paysTermDescstringOptional

Payout Period Description

lotDtstringOptional

Drawing/Confirmation Date

winAncmDtstringOptional

Winner Announcement Date/Time

winAncmDispYnstringOptional

Winner Announcement Display

pmgdSndDtstringOptional

Gift Shipment Date

payDtstringOptional

Point Payout Date/Time

evtUrlAddrstringOptional

Event URL

evtBnrPathNmstringOptional

Event Banner Path

evtBnrFileNmstringOptional

Event Banner File Name

evtBnrAltContstringOptional

Event Banner Image Alt Text

pcEvtBnrPathNmstringOptional

Event Banner Path Name (PC)

pcEvtBnrFileNmstringOptional

Event Banner File Name (PC)

pcEvtBnrAltContstringOptional

Event Banner Image Alt Text for PC

aempIdstringOptional

Person in Charge ID

aempNmstringOptional

Manager Name

adveWrdContstringOptional

Promotional Text Content

pmgdRcvProeContstringOptional

Prize Receiving Procedure Content

dispYnstringOptional

Display Status

expYnstringOptional

Exposure Status

evtSchTagstringOptional

Event Search Tag

indInfoMkusAgrYnstringOptional

Personal Information Usage Consent Status

indInfoMkusAgmtstringOptional

Personal Information Usage Terms

indInfoThprPofAgrYnstringOptional

Personal Information Third-Party Provision Consent Status

indInfoThprPofAgmtstringOptional

Personal Information Third-Party Provision Terms

rnkMgrYnstringOptional

Ranking Management Status

tubaDptStrDtstringOptional

Withholding Tax Deposit Start Date/Time

tubaDptEndDtstringOptional

Withholding Tax Deposit End Date/Time

evtTmplUseYnstringOptional

Event Template Usage Status

evtExpMsgstringOptional

Event Display Message

atndMtrstringOptional

Precautions

acdnUseYnstringOptional

Accordion UI Usage Status

custCntrGdWrdContstringOptional

Customer Center Guide Message Content

sbscAplyDtmstring · date-timeOptional

Application Date/Time

evtStrDtmstring · date-timeOptional

Event Start Date/Time

evtEndDtmstring · date-timeOptional

Event End Date/Time

buyStrDtmstring · date-timeOptional

Purchase Period Start Date

buyEndDtmstring · date-timeOptional

Purchase Period End Date

sbscAplyStrDtmstring · date-timeOptional

Application Period Start Date

sbscAplyEndDtmstring · date-timeOptional

Application Period End Date

sbscPsbMinOrdAmtnumberOptional

Minimum Order Payment Amount for Entry

siteNmstringOptional

Site Name

900

Detail Retrieval Failure

*/*

post/v1/marketing/eventMgmt/getEventDetail

POST /api/bo/v1/marketing/eventMgmt/getEventDetail HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2910

{
  "siteNo": 1,
  "state": "U",
  "reSearchPage": "text",
  "periodGb": 0,
  "startDate": "2026-01-01",
  "endDate": "2026-01-01",
  "dateSelect": "all_day",
  "evtTyp": "text",
  "argSelectType": 1,
  "evtNm": "단순클릭 이벤트",
  "evtNo": 15322,
  "uprFixYn": "Y",
  "evtUrlAddr": "/event/15322",
  "deptCd": 10130,
  "aempId": "abcd",
  "dispYn": "Y",
  "evtPrgsStat": "01",
  "adveWrdCont": "이벤트홍보",
  "evtSchTag": "이벤트",
  "expYn": "Y",
  "mbrGbCdArr": "UNION_MEMBER",
  "mbrGradeCdArr": 10,
  "evtSbscPsbCd": "01",
  "evtExpNmCd": "01",
  "indInfoMkusAgrYn": "N",
  "indInfoMkusAgmt": "text",
  "indInfoThprPofAgrYn": "N",
  "indInfoThprPofAgmt": "text",
  "evtLgrpCd": 20,
  "evtMgrpCd": 30,
  "mbrGradeCd2": 10,
  "evtGbCd": "01",
  "sbscCntLmtCd": "02",
  "evtObjCd": "01",
  "purAmtEvtPromoYn": "N",
  "lotDt": "text",
  "winAncmDt": "text",
  "winAncmDispYn": "Y",
  "payDt": "text",
  "pmgdSndDt": "text",
  "evtBnrPathNm": "files/test/../../test.png",
  "evtBnrFileNm": "test.png",
  "evtBnrAltCont": "배너이미지 대체 텍스트",
  "pcEvtBnrPathNm": "files/test/../../test.png",
  "pcEvtBnrFileNm": "test.png",
  "pcEvtBnrAltCont": "배너이미지 PC용 대체 텍스트",
  "loltList": [
    {
      "evtNo": 15322,
      "evtMgrpCd": 30,
      "aplyRnk": 1,
      "roltPayPnum": 100,
      "roltPrbl": 10,
      "payPoint": 200
    }
  ],
  "attenList": [
    {
      "evtNo": 15322,
      "evtMgrpCd": 30,
      "aplyRnk": 1,
      "roltPayPnum": 100,
      "roltPrbl": 10,
      "payPoint": 200
    }
  ],
  "questList": [
    {
      "evtNo": 15322,
      "questNo": 1,
      "questGbCd": 20,
      "questCont": "이것은 사과입니까?",
      "questQestCnt": 4,
      "cawrCont": "네",
      "dupAnsYn": "Y",
      "mdtyQuestYn": "Y",
      "questExpltList": [
        {
          "evtNo": 15322,
          "questNo": 1,
          "questExplNo": 3,
          "questExplCont": "네",
          "questBnrPathNm": "files/test/../../test.png",
          "questBnrFileNm": "test.png"
        }
      ]
    }
  ],
  "pmgdList": [
    {
      "evtNo": 15322,
      "evtFvrSeq": 1,
      "winRnk": 1,
      "evtFvrTypCd": 10,
      "buyAmt": 50000,
      "payMilg": 50000,
      "evtGoodsNm": "테스트상품",
      "promoNo": 1000000,
      "goodsNo": 1000000,
      "payPnumCnt": 100,
      "pmgdAmt": 10000,
      "winmnChrgYn": "Y",
      "tuba": 2000,
      "winWtpsCnt": 100,
      "payAmt": 100000,
      "etcDesc1": "설명1",
      "etcDesc2": "설명2",
      "etcDesc3": "설명3",
      "etcDesc4": "설명4",
      "etcDesc5": "설명5"
    }
  ],
  "aplyList": [
    {
      "evtNo": "text",
      "custFvrAplyGbCd": 10,
      "custFvrAplyTypCd": 10,
      "fvrTgtNo": "text",
      "siteNm": "text",
      "siteDom": "text",
      "applyCont": "text"
    }
  ],
  "aplySites": [
    "text"
  ],
  "rnkMgrYn": "N",
  "winWtpsCnt": 100,
  "pmgdRcvProeCont": "경품수령절차내용",
  "evetTermDesc": "행사기간설명",
  "evetCondDesc": "행사조건설명",
  "paysTermDesc": "지급기간설명",
  "evtTmplUseYn": "Y",
  "tmplUseGb": "text",
  "tmplDtlCmpsCdArr": 10,
  "htmlFileCont": "text",
  "pcHtmlFileCont": "text",
  "evtExpMsg": "이벤트 노출 메시지",
  "atndMtr": "유의사항",
  "acdnUseYn": "Y",
  "custCntrGdWrdCont": "고객센터안내문구내용",
  "evtNoList": [
    15692,
    15652,
    15562,
    15382
  ],
  "evtStrDtm": "2026-01-01T00:00:00.000Z",
  "evtEndDtm": "2026-01-01T00:00:00.000Z",
  "buyStrDtm": "2026-01-01T00:00:00.000Z",
  "buyEndDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
  "tubaDptStrDt": "2026-01-01T00:00:00.000Z",
  "tubaDptEndDt": "2026-01-01T00:00:00.000Z",
  "sbscPsbMinOrdAmt": 1
}

{
  "reSearchPage": "text",
  "mbrNo": "text",
  "mbrId": "text",
  "mbrNm": "text",
  "mbrEmail": "text",
  "mbrAddr": "text",
  "mbrTel": 1,
  "evtTypNm": "text",
  "evtNo": "text",
  "evtNm": "text",
  "uprFixYn": "text",
  "evtLgrpCd": 20,
  "evtMgrpCd": 30,
  "evtExpNmCd": "01",
  "evtObjCd": "01",
  "evtSbscPsbCd": "01",
  "evtGbCd": "01",
  "sbscCntLmtCd": "02",
  "deptCd": "text",
  "deptNm": "text",
  "evtPrgsStatCd": "01",
  "purAmtEvtPromoYn": "text",
  "evetTermDesc": "text",
  "evetCondDesc": "text",
  "paysTermDesc": "text",
  "lotDt": "text",
  "winAncmDt": "text",
  "winAncmDispYn": "text",
  "pmgdSndDt": "text",
  "payDt": "text",
  "evtUrlAddr": "text",
  "evtBnrPathNm": "text",
  "evtBnrFileNm": "text",
  "evtBnrAltCont": "text",
  "pcEvtBnrPathNm": "text",
  "pcEvtBnrFileNm": "text",
  "pcEvtBnrAltCont": "text",
  "aempId": "text",
  "aempNm": "text",
  "adveWrdCont": "text",
  "pmgdRcvProeCont": "text",
  "dispYn": "text",
  "expYn": "text",
  "evtSchTag": "text",
  "indInfoMkusAgrYn": "text",
  "indInfoMkusAgmt": "text",
  "indInfoThprPofAgrYn": "text",
  "indInfoThprPofAgmt": "text",
  "rnkMgrYn": "text",
  "tubaDptStrDt": "text",
  "tubaDptEndDt": "text",
  "evtTmplUseYn": "text",
  "mbrGbCdList": [
    {
      "evtNo": "text",
      "expGradeGbCd": "text",
      "expTgtNo": "text"
    }
  ],
  "mbrGradeCdList": [
    {
      "evtNo": "text",
      "expGradeGbCd": "text",
      "expTgtNo": "text"
    }
  ],
  "dispMbrGradeList": [
    {
      "evtNo": "text",
      "expGradeGbCd": "text",
      "expTgtNo": "text"
    }
  ],
  "loltList": [
    {
      "evtNo": "text",
      "evtMgrpCd": "text",
      "aplyRnk": 1,
      "roltPayPnum": 1,
      "roltPrbl": 1,
      "payPoint": 1
    }
  ],
  "attenList": [
    {
      "evtNo": "text",
      "evtMgrpCd": "text",
      "aplyRnk": 1,
      "roltPayPnum": 1,
      "roltPrbl": 1,
      "payPoint": 1
    }
  ],
  "questList": [
    {
      "evtNo": "text",
      "questNo": "text",
      "questGbCd": 20,
      "questCont": "text",
      "questQestCnt": 1,
      "cawrCont": "text",
      "dupAnsYn": "text",
      "mdtyQuestYn": "text",
      "questExpltList": [
        {
          "evtNo": "text",
          "questNo": "text",
          "questExplNo": "text",
          "questExplCont": "text",
          "questBnrPathNm": "text",
          "questBnrFileNm": "text"
        }
      ]
    }
  ],
  "pmgdList": [
    {
      "evtNo": "text",
      "evtFvrSeq": "text",
      "winRnk": 1,
      "evtFvrTypCd": 10,
      "evtFvrTypNm": "text",
      "buyAmt": 1,
      "payMilg": 1,
      "evtGoodsNm": "text",
      "promoNo": "text",
      "goodsNo": "text",
      "payPnumCnt": 1,
      "pmgdAmt": 1,
      "winmnChrgYn": "text",
      "tuba": 1,
      "winWtpsCnt": 1,
      "etcDesc1": "text",
      "etcDesc2": "text",
      "etcDesc3": "text",
      "etcDesc4": "text",
      "etcDesc5": "text",
      "trgmnCount": 1,
      "doingYn": "text",
      "pcount": 1
    }
  ],
  "tmplRelInfoList": [
    {
      "evtNo": "text",
      "evtTmplRelNo": "text",
      "tmplNo": "text",
      "tmplDtlGbCd": "text",
      "tmplDtlCmpsCd": "text",
      "tmplDtlSeq": "text",
      "htmlFileCont": "text",
      "pcHtmlFileCont": "text",
      "etcWrtCont": "text",
      "wrtRtGbCd": "text",
      "listPrtCntCd": "text",
      "bkgrImgPathNm": "text",
      "bkgrImgFileNm": "text",
      "bbSharYn": "text"
    }
  ],
  "tmplDtlInfoList": [
    {
      "tmplNo": "text",
      "tmplDtlGbCd": 10,
      "tmplDtlSeq": "text",
      "tmplDtlCmpsCd": 11,
      "tmplPrioRnk": "text",
      "htmlFileCont": "text",
      "pcHtmlFileCont": "text"
    }
  ],
  "evtExpMsg": "text",
  "atndMtr": "text",
  "acdnUseYn": "text",
  "custCntrGdWrdCont": "text",
  "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
  "evtStrDtm": "2026-01-01T00:00:00.000Z",
  "evtEndDtm": "2026-01-01T00:00:00.000Z",
  "buyStrDtm": "2026-01-01T00:00:00.000Z",
  "buyEndDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
  "sbscPsbMinOrdAmt": 1,
  "siteNm": "text",
  "aplySites": [
    "{'data':'플래티어닷컴',key:'1'}"
  ]
}

Send Event Test Email

post

Function Description

• Sends a test email for the event.

---

Detailed Description

• Sends an email to the registered test account's email address.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

evtNostringOptional

Event No.

evtNmstringOptional

Event Name

trgmnSeqstringOptional

Entrant Sequence No.

sndSeqstringOptional

Send Sequence No.

sndMethCdstring · enumOptional

Send Method Code (EV013)

Example: 01Possible values:

sndYnstringOptional

Sending Status

sndTmplCdstringOptional

Send Template Code

emailTitleNmstringOptional

Email Subject

sndContstringOptional

Send Content

evtTermExpYnstringOptional

Promotion Period Display Status

sbscTermExpYnstringOptional

Application Period Display Status

winAncmDtExpYnstringOptional

Winner Announcement Date Display Status

sndDtExpYnstringOptional

Send Date Display Status

lotListDpYnstringOptional

Winning Details Display Status

lotListContstringOptional

Winning Details Content

winAncmDtstringOptional

Winner Announcement Date/Time

payDtstringOptional

Payment Date

pmgdSndDtstringOptional

Send Date

tubaDptStrDtstringOptional

Tax and Public Dues Payment Deadline Start Date

tubaDptEndDtstringOptional

Tax and Public Dues Payment Deadline End Date

additionalAreaContstringOptional

Additional Area Content

sndDtmstring · date-timeOptional

Send Date/Time

sndTestDtmstring · date-timeOptional

Send Test Date and Time

evtStrDtmstring · date-timeOptional

Promotion Period Start Date

evtEndDtmstring · date-timeOptional

Promotion Period End Date

sbscAplyStrDtmstring · date-timeOptional

Application Period Start Date

sbscAplyEndDtmstring · date-timeOptional

Application Period End Date

Responses

200

Test Email Sent Successfully

*/*

stringOptional

900

Test Email Send Failure

*/*

post/v1/marketing/eventMgmt/eventMgmtTestEmailSend

POST /api/bo/v1/marketing/eventMgmt/eventMgmtTestEmailSend HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 768

{
  "evtNo": "text",
  "evtNm": "text",
  "trgmnSeq": "text",
  "sndSeq": "text",
  "sndMethCd": "01",
  "sndYn": "text",
  "sndTmplCd": "text",
  "emailTitleNm": "text",
  "sndCont": "text",
  "evtTermExpYn": "text",
  "sbscTermExpYn": "text",
  "winAncmDtExpYn": "text",
  "sndDtExpYn": "text",
  "lotListDpYn": "text",
  "lotListCont": "text",
  "winAncmDt": "text",
  "payDt": "text",
  "pmgdSndDt": "text",
  "tubaDptStrDt": "text",
  "tubaDptEndDt": "text",
  "additionalAreaCont": "text",
  "trgmnInfoList": [
    {
      "evtNo": 15322,
      "trgmnSeq": 1,
      "sndSeq": 1,
      "resndYn": "N",
      "resndCausCd": "02",
      "emailAddr": "[e-mail]"
    }
  ],
  "sndDtm": "2026-01-01T00:00:00.000Z",
  "sndTestDtm": "2026-01-01T00:00:00.000Z",
  "evtStrDtm": "2026-01-01T00:00:00.000Z",
  "evtEndDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
  "sbscAplyEndDtm": "2026-01-01T00:00:00.000Z"
}

text

Default Setting of Event Scope Category on Event Registration

post

Function Description

• Sets the default Event Scope category when registering an event.

---

Detailed Description

• Event No. (evtNo), Customer Benefit Application Type Code (EV008) (custFvrAplyGbCd), Customer Benefit Application Category Code (EV009) (custFvrAplyTypCd), Benefit Target No. (fvrTgtNo) are required.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

evtNostringOptional

Event No.

custFvrAplyGbCdstring · enumOptional

Customer Benefit Application Type Code (EV008)

Example: 10Possible values:

custFvrAplyTypCdstring · enumOptional

Customer Benefit Application Category Code (EV009)

Example: 10Possible values:

fvrTgtNostringOptional

Benefit Target No.

siteNmstringOptional

Site Name

siteDomstringOptional

Site Domain

applyContstringOptional

Application Details

Responses

200

Category Setting Success

*/*

stringOptional

900

Category Setting Failure

*/*

post/v1/marketing/eventMgmt/addEventMgmtApplyCategory

POST /api/bo/v1/marketing/eventMgmt/addEventMgmtApplyCategory HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 129

{
  "evtNo": "text",
  "custFvrAplyGbCd": 10,
  "custFvrAplyTypCd": 10,
  "fvrTgtNo": "text",
  "siteNm": "text",
  "siteDom": "text",
  "applyCont": "text"
}

text

Retrieve Test Group Management List

get

Function Description

• Retrieves the Test Group Management grid list.

---

Detailed Description

• No required values.

• Retrieves the grid list of Test Group Management.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

pageIdxstringRequired

Current Page

Example: 1

rowsPerPagestringRequired

Rows per Page

Example: 10

Responses

200

List Retrieved Successfully

*/*

totalCountinteger · int32Optional

900

List Retrieval Failed

*/*

get/v2/marketing/eventMgmt/getTestGrpInfoMgmtList

GET /api/bo/v2/marketing/eventMgmt/getTestGrpInfoMgmtList?pageIdx=text&rowsPerPage=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "testGrpNo": "text",
      "testUserNm": "text",
      "cellSctNo": "text",
      "cellTxnoNo": "text",
      "cellEndNo": "text",
      "emailAddr": "text"
    }
  ]
}

Retrieve Event Target Member Information List

get

Function Description

     * Retrieves the event target member information list.
     ---
     ## Detailed Description
     * **Event No. (evtNo)** is required.
     * Retrieves the target member information for the event via the evtNo parameter.

---

Revision History

• Release v2.00_240829 : Updated masking processing

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

List Retrieved Successfully

*/*

totalCountinteger · int32Optional

900

List Retrieval Failed

*/*

get/v2/marketing/eventMgmt/getEventPayMgmtTrgmnInfoList

GET /api/bo/v2/marketing/eventMgmt/getEventPayMgmtTrgmnInfoList?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "qryGbCd": 20,
      "indInfoQryCaus": "환불처리작업",
      "evtMgrpCd": 30,
      "trgmnSeq": "text",
      "evtFvrTypCd": 10,
      "evtTrgmnGbCd": "04",
      "mbrNo": "text",
      "winRnk": 1,
      "winCnclCausCont": "text",
      "evtNo": "text",
      "waitRnk": 1,
      "intx": 1,
      "citx": 1,
      "ordSumAmt": 1,
      "cfmOrdAmt": 1,
      "evtSbscPathCd": "text",
      "tubaBankCd": "text",
      "tubaDepositorNm": "text",
      "tubaVirActnNo": "text",
      "tubaDptAmt": 1,
      "deliHdcCd": 10,
      "deliInvNo": "text",
      "mailSndCnt": 1,
      "mailSndFailCnt": 1,
      "bbcNo": "text",
      "lotCondSeq": "text",
      "etcGftDlvpNo": "text",
      "paysYn": "text",
      "mbrNm": "text",
      "loginId": "text",
      "emailAddr": "text",
      "zipAddr": "text",
      "dtlAddr": "text",
      "cellNo": "text",
      "cellSctNo": "text",
      "cellTxnoNo": "text",
      "cellEndNo": "text",
      "errorMessage": "text",
      "lotStat": "text",
      "lotGb": "text",
      "waitGb": "text",
      "realGoods": "text",
      "realGoodsNm": "text",
      "pmgdSndDt": "text",
      "payDt": "text",
      "payMilg": 1,
      "payPoint": "text",
      "rcvmnNm": "text",
      "deliZipNo": "text",
      "deliZipAddr": "text",
      "deliZipDtlAddr": "text",
      "deliCellSctNo": "text",
      "deliCellTxnoNo": "text",
      "deliCellEndNo": "text",
      "pmgdAmt": "text",
      "realPoint": "text",
      "resndYn": "text",
      "evtNm": "text",
      "aempId": "text",
      "aempNm": "text",
      "startDate": "text",
      "endDate": "text",
      "mbrSexGb": "text",
      "mbrAge": "text",
      "buyAmt": 1,
      "bbcCont": "text",
      "excpTrgmnYn": "text",
      "lgcMbrNo": "text",
      "deliMsg": "text",
      "comnFrdrEtcMethod": "text",
      "comnFrdrPwd": "text",
      "realCouponNm": "text",
      "trnsYn": "text",
      "evtFvrSeq": "text",
      "winmnChrgYn": "text",
      "tuba": 1,
      "promoNo": "text",
      "mbrGradeCd": "text",
      "tubaEnterYn": "text",
      "goodsGiftsNm": "text",
      "changePossibleYn": "text",
      "arrSndMethCd": "text",
      "arrSndMethNm": "text",
      "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
      "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
      "winDtm": "2026-01-01T00:00:00.000Z",
      "winCnclDtm": "2026-01-01T00:00:00.000Z",
      "myCertiDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptDtm": "2026-01-01T00:00:00.000Z",
      "buyDtm": "2026-01-01T00:00:00.000Z",
      "paysDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "sbscPsbMinOrdAmt": 1,
      "stafYn": "text",
      "lotType": "text",
      "mbrYn": "text",
      "lotYn": "text"
    }
  ]
}

Retrieve Event Entry Management List

get

Function Description

     * Retrieves the Event Entry Management grid list.
     ---
     ## Detailed Description
     * **Event No. (evtNo)** is required.
     * Retrieves the applicant history for the event via the evtNo parameter.
     * Sort condition
         * By applicant sequence number

---

Revision History

• Release v2.00_240829 : Updated masking processing

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

pageIdxstringRequired

Current Page

Example: 1

rowsPerPagestringRequired

Rows per Page

Example: 10

Responses

200

List Retrieved Successfully

*/*

totalCountinteger · int32Optional

900

List Retrieval Failed

*/*

get/v2/marketing/eventMgmt/getEventMgmtTrgmnInfoList

GET /api/bo/v2/marketing/eventMgmt/getEventMgmtTrgmnInfoList?evtNo=text&pageIdx=text&rowsPerPage=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "qryGbCd": 20,
      "indInfoQryCaus": "환불처리작업",
      "evtMgrpCd": 30,
      "trgmnSeq": "text",
      "evtFvrTypCd": 10,
      "evtTrgmnGbCd": "04",
      "mbrNo": "text",
      "winRnk": 1,
      "winCnclCausCont": "text",
      "evtNo": "text",
      "waitRnk": 1,
      "intx": 1,
      "citx": 1,
      "ordSumAmt": 1,
      "cfmOrdAmt": 1,
      "evtSbscPathCd": "text",
      "tubaBankCd": "text",
      "tubaDepositorNm": "text",
      "tubaVirActnNo": "text",
      "tubaDptAmt": 1,
      "deliHdcCd": 10,
      "deliInvNo": "text",
      "mailSndCnt": 1,
      "mailSndFailCnt": 1,
      "bbcNo": "text",
      "lotCondSeq": "text",
      "etcGftDlvpNo": "text",
      "paysYn": "text",
      "mbrNm": "text",
      "loginId": "text",
      "emailAddr": "text",
      "zipAddr": "text",
      "dtlAddr": "text",
      "cellNo": "text",
      "cellSctNo": "text",
      "cellTxnoNo": "text",
      "cellEndNo": "text",
      "errorMessage": "text",
      "lotStat": "text",
      "lotGb": "text",
      "waitGb": "text",
      "realGoods": "text",
      "realGoodsNm": "text",
      "pmgdSndDt": "text",
      "payDt": "text",
      "payMilg": 1,
      "payPoint": "text",
      "rcvmnNm": "text",
      "deliZipNo": "text",
      "deliZipAddr": "text",
      "deliZipDtlAddr": "text",
      "deliCellSctNo": "text",
      "deliCellTxnoNo": "text",
      "deliCellEndNo": "text",
      "pmgdAmt": "text",
      "realPoint": "text",
      "resndYn": "text",
      "evtNm": "text",
      "aempId": "text",
      "aempNm": "text",
      "startDate": "text",
      "endDate": "text",
      "mbrSexGb": "text",
      "mbrAge": "text",
      "buyAmt": 1,
      "bbcCont": "text",
      "excpTrgmnYn": "text",
      "lgcMbrNo": "text",
      "deliMsg": "text",
      "comnFrdrEtcMethod": "text",
      "comnFrdrPwd": "text",
      "realCouponNm": "text",
      "trnsYn": "text",
      "evtFvrSeq": "text",
      "winmnChrgYn": "text",
      "tuba": 1,
      "promoNo": "text",
      "mbrGradeCd": "text",
      "tubaEnterYn": "text",
      "goodsGiftsNm": "text",
      "changePossibleYn": "text",
      "arrSndMethCd": "text",
      "arrSndMethNm": "text",
      "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
      "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
      "winDtm": "2026-01-01T00:00:00.000Z",
      "winCnclDtm": "2026-01-01T00:00:00.000Z",
      "myCertiDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptDtm": "2026-01-01T00:00:00.000Z",
      "buyDtm": "2026-01-01T00:00:00.000Z",
      "paysDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "sbscPsbMinOrdAmt": 1,
      "stafYn": "text",
      "lotType": "text",
      "mbrYn": "text",
      "lotYn": "text"
    }
  ]
}

Retrieve Event Target Member Information List - Email

get

Function Description

     * Retrieves the event target member information list - Email
     ---
     ## Detailed Description
     * **Event No. (evtNo)** is required.
     ---

Revision History

• Release v2.00_240829 : Updated masking processing

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

List Retrieved Successfully

*/*

totalCountinteger · int32Optional

900

List Retrieval Failed

*/*

get/v2/marketing/eventMgmt/getEventMgmtSendWinnerInfoList

GET /api/bo/v2/marketing/eventMgmt/getEventMgmtSendWinnerInfoList?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "qryGbCd": 20,
      "indInfoQryCaus": "환불처리작업",
      "evtMgrpCd": 30,
      "trgmnSeq": "text",
      "evtFvrTypCd": 10,
      "evtTrgmnGbCd": "04",
      "mbrNo": "text",
      "winRnk": 1,
      "winCnclCausCont": "text",
      "evtNo": "text",
      "waitRnk": 1,
      "intx": 1,
      "citx": 1,
      "ordSumAmt": 1,
      "cfmOrdAmt": 1,
      "evtSbscPathCd": "text",
      "tubaBankCd": "text",
      "tubaDepositorNm": "text",
      "tubaVirActnNo": "text",
      "tubaDptAmt": 1,
      "deliHdcCd": 10,
      "deliInvNo": "text",
      "mailSndCnt": 1,
      "mailSndFailCnt": 1,
      "bbcNo": "text",
      "lotCondSeq": "text",
      "etcGftDlvpNo": "text",
      "paysYn": "text",
      "mbrNm": "text",
      "loginId": "text",
      "emailAddr": "text",
      "zipAddr": "text",
      "dtlAddr": "text",
      "cellNo": "text",
      "cellSctNo": "text",
      "cellTxnoNo": "text",
      "cellEndNo": "text",
      "errorMessage": "text",
      "lotStat": "text",
      "lotGb": "text",
      "waitGb": "text",
      "realGoods": "text",
      "realGoodsNm": "text",
      "pmgdSndDt": "text",
      "payDt": "text",
      "payMilg": 1,
      "payPoint": "text",
      "rcvmnNm": "text",
      "deliZipNo": "text",
      "deliZipAddr": "text",
      "deliZipDtlAddr": "text",
      "deliCellSctNo": "text",
      "deliCellTxnoNo": "text",
      "deliCellEndNo": "text",
      "pmgdAmt": "text",
      "realPoint": "text",
      "resndYn": "text",
      "evtNm": "text",
      "aempId": "text",
      "aempNm": "text",
      "startDate": "text",
      "endDate": "text",
      "mbrSexGb": "text",
      "mbrAge": "text",
      "buyAmt": 1,
      "bbcCont": "text",
      "excpTrgmnYn": "text",
      "lgcMbrNo": "text",
      "deliMsg": "text",
      "comnFrdrEtcMethod": "text",
      "comnFrdrPwd": "text",
      "realCouponNm": "text",
      "trnsYn": "text",
      "evtFvrSeq": "text",
      "winmnChrgYn": "text",
      "tuba": 1,
      "promoNo": "text",
      "mbrGradeCd": "text",
      "tubaEnterYn": "text",
      "goodsGiftsNm": "text",
      "changePossibleYn": "text",
      "arrSndMethCd": "text",
      "arrSndMethNm": "text",
      "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
      "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
      "winDtm": "2026-01-01T00:00:00.000Z",
      "winCnclDtm": "2026-01-01T00:00:00.000Z",
      "myCertiDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptDtm": "2026-01-01T00:00:00.000Z",
      "buyDtm": "2026-01-01T00:00:00.000Z",
      "paysDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "sbscPsbMinOrdAmt": 1,
      "stafYn": "text",
      "lotType": "text",
      "mbrYn": "text",
      "lotYn": "text"
    }
  ]
}

Retrieve Event Scope Category List

get

Function Description

• Retrieves the Event Scope category list.

---

Detailed Description

• Event No. (evtNo) is required.

• Retrieves the applicable scope category for the event via the evtNo parameter.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

Category List Retrieval Success

*/*

totalCountinteger · int32Optional

900

Category List Retrieval Failure

*/*

get/v2/marketing/eventMgmt/getEventMgmtApplyCategoryList

GET /api/bo/v2/marketing/eventMgmt/getEventMgmtApplyCategoryList?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "evtNo": "text",
      "custFvrAplyGbCd": 10,
      "custFvrAplyTypCd": 10,
      "fvrTgtNo": "text",
      "siteNm": "text",
      "siteDom": "text",
      "applyCont": "text"
    }
  ]
}

Retrieve Event Drawing Management List

get

Function Description

     * Retrieves the Event Drawing Management grid list.
     ---
     ## Detailed Description
     * **Event No. (evtNo)** is required.
     * Retrieves the drawing list for the event via the evtNo parameter.

---

Revision History

• Release v2.00_240829 : Updated masking processing

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

pageIdxstringRequired

Current Page

Example: 1

rowsPerPagestringRequired

Rows per Page

Example: 10

Responses

200

List Retrieved Successfully

*/*

totalCountinteger · int32Optional

900

List Retrieval Failed

*/*

get/v2/marketing/eventMgmt/getEventLotMgmtTrgmnInfoList

GET /api/bo/v2/marketing/eventMgmt/getEventLotMgmtTrgmnInfoList?evtNo=text&pageIdx=text&rowsPerPage=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "qryGbCd": 20,
      "indInfoQryCaus": "환불처리작업",
      "evtMgrpCd": 30,
      "trgmnSeq": "text",
      "evtFvrTypCd": 10,
      "evtTrgmnGbCd": "04",
      "mbrNo": "text",
      "winRnk": 1,
      "winCnclCausCont": "text",
      "evtNo": "text",
      "waitRnk": 1,
      "intx": 1,
      "citx": 1,
      "ordSumAmt": 1,
      "cfmOrdAmt": 1,
      "evtSbscPathCd": "text",
      "tubaBankCd": "text",
      "tubaDepositorNm": "text",
      "tubaVirActnNo": "text",
      "tubaDptAmt": 1,
      "deliHdcCd": 10,
      "deliInvNo": "text",
      "mailSndCnt": 1,
      "mailSndFailCnt": 1,
      "bbcNo": "text",
      "lotCondSeq": "text",
      "etcGftDlvpNo": "text",
      "paysYn": "text",
      "mbrNm": "text",
      "loginId": "text",
      "emailAddr": "text",
      "zipAddr": "text",
      "dtlAddr": "text",
      "cellNo": "text",
      "cellSctNo": "text",
      "cellTxnoNo": "text",
      "cellEndNo": "text",
      "errorMessage": "text",
      "lotStat": "text",
      "lotGb": "text",
      "waitGb": "text",
      "realGoods": "text",
      "realGoodsNm": "text",
      "pmgdSndDt": "text",
      "payDt": "text",
      "payMilg": 1,
      "payPoint": "text",
      "rcvmnNm": "text",
      "deliZipNo": "text",
      "deliZipAddr": "text",
      "deliZipDtlAddr": "text",
      "deliCellSctNo": "text",
      "deliCellTxnoNo": "text",
      "deliCellEndNo": "text",
      "pmgdAmt": "text",
      "realPoint": "text",
      "resndYn": "text",
      "evtNm": "text",
      "aempId": "text",
      "aempNm": "text",
      "startDate": "text",
      "endDate": "text",
      "mbrSexGb": "text",
      "mbrAge": "text",
      "buyAmt": 1,
      "bbcCont": "text",
      "excpTrgmnYn": "text",
      "lgcMbrNo": "text",
      "deliMsg": "text",
      "comnFrdrEtcMethod": "text",
      "comnFrdrPwd": "text",
      "realCouponNm": "text",
      "trnsYn": "text",
      "evtFvrSeq": "text",
      "winmnChrgYn": "text",
      "tuba": 1,
      "promoNo": "text",
      "mbrGradeCd": "text",
      "tubaEnterYn": "text",
      "goodsGiftsNm": "text",
      "changePossibleYn": "text",
      "arrSndMethCd": "text",
      "arrSndMethNm": "text",
      "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
      "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
      "winDtm": "2026-01-01T00:00:00.000Z",
      "winCnclDtm": "2026-01-01T00:00:00.000Z",
      "myCertiDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptDtm": "2026-01-01T00:00:00.000Z",
      "buyDtm": "2026-01-01T00:00:00.000Z",
      "paysDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "sbscPsbMinOrdAmt": 1,
      "stafYn": "text",
      "lotType": "text",
      "mbrYn": "text",
      "lotYn": "text"
    }
  ]
}

Retrieve Event Target Member Selection Result List

get

Function Description

     * Retrieves the Event Target Member Selection Result - grid list.
     ---
     ## Detailed Description
     * **Event No. (evtNo)** is required.
     * Retrieves the target member selection result list for the event via the evtNo parameter.

---

Revision History

• Release v2.00_240829 : Updated masking processing

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

pageIdxstringRequired

Current Page

Example: 1

rowsPerPagestringRequired

Rows per Page

Example: 10

Responses

200

Grid Retrieved Successfully

*/*

totalCountinteger · int32Optional

900

Grid Retrieval Failed

*/*

get/v2/marketing/eventMgmt/getEventLotMgmtCcTrgmnInfoSelectedResultList

GET /api/bo/v2/marketing/eventMgmt/getEventLotMgmtCcTrgmnInfoSelectedResultList?evtNo=text&pageIdx=text&rowsPerPage=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "qryGbCd": 20,
      "indInfoQryCaus": "환불처리작업",
      "evtMgrpCd": 30,
      "trgmnSeq": "text",
      "evtFvrTypCd": 10,
      "evtTrgmnGbCd": "04",
      "mbrNo": "text",
      "winRnk": 1,
      "winCnclCausCont": "text",
      "evtNo": "text",
      "waitRnk": 1,
      "intx": 1,
      "citx": 1,
      "ordSumAmt": 1,
      "cfmOrdAmt": 1,
      "evtSbscPathCd": "text",
      "tubaBankCd": "text",
      "tubaDepositorNm": "text",
      "tubaVirActnNo": "text",
      "tubaDptAmt": 1,
      "deliHdcCd": 10,
      "deliInvNo": "text",
      "mailSndCnt": 1,
      "mailSndFailCnt": 1,
      "bbcNo": "text",
      "lotCondSeq": "text",
      "etcGftDlvpNo": "text",
      "paysYn": "text",
      "mbrNm": "text",
      "loginId": "text",
      "emailAddr": "text",
      "zipAddr": "text",
      "dtlAddr": "text",
      "cellNo": "text",
      "cellSctNo": "text",
      "cellTxnoNo": "text",
      "cellEndNo": "text",
      "errorMessage": "text",
      "lotStat": "text",
      "lotGb": "text",
      "waitGb": "text",
      "realGoods": "text",
      "realGoodsNm": "text",
      "pmgdSndDt": "text",
      "payDt": "text",
      "payMilg": 1,
      "payPoint": "text",
      "rcvmnNm": "text",
      "deliZipNo": "text",
      "deliZipAddr": "text",
      "deliZipDtlAddr": "text",
      "deliCellSctNo": "text",
      "deliCellTxnoNo": "text",
      "deliCellEndNo": "text",
      "pmgdAmt": "text",
      "realPoint": "text",
      "resndYn": "text",
      "evtNm": "text",
      "aempId": "text",
      "aempNm": "text",
      "startDate": "text",
      "endDate": "text",
      "mbrSexGb": "text",
      "mbrAge": "text",
      "buyAmt": 1,
      "bbcCont": "text",
      "excpTrgmnYn": "text",
      "lgcMbrNo": "text",
      "deliMsg": "text",
      "comnFrdrEtcMethod": "text",
      "comnFrdrPwd": "text",
      "realCouponNm": "text",
      "trnsYn": "text",
      "evtFvrSeq": "text",
      "winmnChrgYn": "text",
      "tuba": 1,
      "promoNo": "text",
      "mbrGradeCd": "text",
      "tubaEnterYn": "text",
      "goodsGiftsNm": "text",
      "changePossibleYn": "text",
      "arrSndMethCd": "text",
      "arrSndMethNm": "text",
      "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
      "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
      "winDtm": "2026-01-01T00:00:00.000Z",
      "winCnclDtm": "2026-01-01T00:00:00.000Z",
      "myCertiDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptDtm": "2026-01-01T00:00:00.000Z",
      "buyDtm": "2026-01-01T00:00:00.000Z",
      "paysDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "sbscPsbMinOrdAmt": 1,
      "stafYn": "text",
      "lotType": "text",
      "mbrYn": "text",
      "lotYn": "text"
    }
  ]
}

Retrieve Event Target Member Drawing Result List

get

Function Description

     * Retrieves the Event Target Member Drawing Result - grid list.
     ---
     ## Detailed Description
     * **Event No. (evtNo)** is required.
     * Retrieves the drawing result of applicants for the event via the evtNo parameter.

---

Revision History

• Release v2.00_240829 : Updated masking processing

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

pageIdxstringRequired

Current Page

Example: 1

rowsPerPagestringRequired

Rows per Page

Example: 10

Responses

200

Grid Retrieved Successfully

*/*

totalCountinteger · int32Optional

900

Grid Retrieval Failed

*/*

get/v2/marketing/eventMgmt/getEventLotMgmtCcTrgmnInfoLotResultList

GET /api/bo/v2/marketing/eventMgmt/getEventLotMgmtCcTrgmnInfoLotResultList?evtNo=text&pageIdx=text&rowsPerPage=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "qryGbCd": 20,
      "indInfoQryCaus": "환불처리작업",
      "evtMgrpCd": 30,
      "trgmnSeq": "text",
      "evtFvrTypCd": 10,
      "evtTrgmnGbCd": "04",
      "mbrNo": "text",
      "winRnk": 1,
      "winCnclCausCont": "text",
      "evtNo": "text",
      "waitRnk": 1,
      "intx": 1,
      "citx": 1,
      "ordSumAmt": 1,
      "cfmOrdAmt": 1,
      "evtSbscPathCd": "text",
      "tubaBankCd": "text",
      "tubaDepositorNm": "text",
      "tubaVirActnNo": "text",
      "tubaDptAmt": 1,
      "deliHdcCd": 10,
      "deliInvNo": "text",
      "mailSndCnt": 1,
      "mailSndFailCnt": 1,
      "bbcNo": "text",
      "lotCondSeq": "text",
      "etcGftDlvpNo": "text",
      "paysYn": "text",
      "mbrNm": "text",
      "loginId": "text",
      "emailAddr": "text",
      "zipAddr": "text",
      "dtlAddr": "text",
      "cellNo": "text",
      "cellSctNo": "text",
      "cellTxnoNo": "text",
      "cellEndNo": "text",
      "errorMessage": "text",
      "lotStat": "text",
      "lotGb": "text",
      "waitGb": "text",
      "realGoods": "text",
      "realGoodsNm": "text",
      "pmgdSndDt": "text",
      "payDt": "text",
      "payMilg": 1,
      "payPoint": "text",
      "rcvmnNm": "text",
      "deliZipNo": "text",
      "deliZipAddr": "text",
      "deliZipDtlAddr": "text",
      "deliCellSctNo": "text",
      "deliCellTxnoNo": "text",
      "deliCellEndNo": "text",
      "pmgdAmt": "text",
      "realPoint": "text",
      "resndYn": "text",
      "evtNm": "text",
      "aempId": "text",
      "aempNm": "text",
      "startDate": "text",
      "endDate": "text",
      "mbrSexGb": "text",
      "mbrAge": "text",
      "buyAmt": 1,
      "bbcCont": "text",
      "excpTrgmnYn": "text",
      "lgcMbrNo": "text",
      "deliMsg": "text",
      "comnFrdrEtcMethod": "text",
      "comnFrdrPwd": "text",
      "realCouponNm": "text",
      "trnsYn": "text",
      "evtFvrSeq": "text",
      "winmnChrgYn": "text",
      "tuba": 1,
      "promoNo": "text",
      "mbrGradeCd": "text",
      "tubaEnterYn": "text",
      "goodsGiftsNm": "text",
      "changePossibleYn": "text",
      "arrSndMethCd": "text",
      "arrSndMethNm": "text",
      "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
      "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
      "winDtm": "2026-01-01T00:00:00.000Z",
      "winCnclDtm": "2026-01-01T00:00:00.000Z",
      "myCertiDtm": "2026-01-01T00:00:00.000Z",
      "tubaDptDtm": "2026-01-01T00:00:00.000Z",
      "buyDtm": "2026-01-01T00:00:00.000Z",
      "paysDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "sbscPsbMinOrdAmt": 1,
      "stafYn": "text",
      "lotType": "text",
      "mbrYn": "text",
      "lotYn": "text"
    }
  ]
}

Retrieve Event Drawing Information

get

Function Description

     * Retrieves the numeric information for the event drawing popup.
     ---
     ## Detailed Description
     * **Event No. (evtNo)** is required.
     * Retrieves the drawing numeric information for the event via the evtNo parameter.

---

Revision History

• Release v2.00_240829 : Updated masking processing

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

Grid Retrieved Successfully

*/*

winnerCountinteger · int32Optional

waitCountinteger · int32Optional

waitWinnerCountinteger · int32Optional

900

Grid Retrieval Failed

*/*

get/v2/marketing/eventMgmt/getEventLotCount

GET /api/bo/v2/marketing/eventMgmt/getEventLotCount?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "winnerCount": 1,
  "waitCount": 1,
  "waitWinnerCount": 1
}

Retrieve Event Management List

get

Function Description

• Retrieves the Event Information Management grid list.

---

Detailed Description

• No required values.

• Search Period (startDate/EndDate), Site No. (siteNo), Event No./Name (evtNo), Event Type (evtTyp), Management Status (evtPrgsStat), Display Status (dispYn), Top Fixed Status (upFixYn), Department in Charge (deptCd), Person in Charge (aempId)

• Retrieves data matching the conditions passed via the above parameters.

• Sort condition

  • By event registration date and time

---

Revision History

• Release v2.00_240425: Added site information to list search conditions and results

• Release v2.00_240530: Changed date query

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringOptional

Event No.

Example: 791

startDatestringOptional

Start Date

Example: 2023-08-01

endDatestringOptional

Last Day

Example: 2023-09-14

evtLgrpCdstringOptional

Event Major Category Code

Example: 10

evtTypstringOptional

Event Type

Example: 13

evtNmstringOptional

Event Name

Example: 이벤트

aempIdstringOptional

Person in Charge ID

Example: x2bee

deptCdstringOptional

Department Code

Example: 10095

dispYnstringOptional

Display Status

Example: Y

evtPrgsStatstringOptional

Event Progress Status

Example: 01

evtGbCdstringOptional

Event Classification Code

Example: 10

siteNostringOptional

Site No.

Example: 1

pageIdxstringRequired

Current Page

Example: 1

rowsPerPagestringRequired

Rows per Page

Example: 10

dateSelectstringRequired

Period Selection Type

Example: all_day

Responses

200

Success

*/*

totalCountinteger · int32Optional

900

Failure

*/*

get/v2/marketing/eventMgmt/getEventList

GET /api/bo/v2/marketing/eventMgmt/getEventList?pageIdx=text&rowsPerPage=text&dateSelect=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "reSearchPage": "text",
      "mbrNo": "text",
      "mbrId": "text",
      "mbrNm": "text",
      "mbrEmail": "text",
      "mbrAddr": "text",
      "mbrTel": 1,
      "evtTypNm": "text",
      "evtNo": "text",
      "evtNm": "text",
      "uprFixYn": "text",
      "evtLgrpCd": 20,
      "evtMgrpCd": 30,
      "evtExpNmCd": "01",
      "evtObjCd": "01",
      "evtSbscPsbCd": "01",
      "evtGbCd": "01",
      "sbscCntLmtCd": "02",
      "deptCd": "text",
      "deptNm": "text",
      "evtPrgsStatCd": "01",
      "purAmtEvtPromoYn": "text",
      "evetTermDesc": "text",
      "evetCondDesc": "text",
      "paysTermDesc": "text",
      "lotDt": "text",
      "winAncmDt": "text",
      "winAncmDispYn": "text",
      "pmgdSndDt": "text",
      "payDt": "text",
      "evtUrlAddr": "text",
      "evtBnrPathNm": "text",
      "evtBnrFileNm": "text",
      "evtBnrAltCont": "text",
      "pcEvtBnrPathNm": "text",
      "pcEvtBnrFileNm": "text",
      "pcEvtBnrAltCont": "text",
      "aempId": "text",
      "aempNm": "text",
      "adveWrdCont": "text",
      "pmgdRcvProeCont": "text",
      "dispYn": "text",
      "expYn": "text",
      "evtSchTag": "text",
      "indInfoMkusAgrYn": "text",
      "indInfoMkusAgmt": "text",
      "indInfoThprPofAgrYn": "text",
      "indInfoThprPofAgmt": "text",
      "rnkMgrYn": "text",
      "tubaDptStrDt": "text",
      "tubaDptEndDt": "text",
      "evtTmplUseYn": "text",
      "mbrGbCdList": [
        {
          "evtNo": "text",
          "expGradeGbCd": "text",
          "expTgtNo": "text"
        }
      ],
      "mbrGradeCdList": [
        {
          "evtNo": "text",
          "expGradeGbCd": "text",
          "expTgtNo": "text"
        }
      ],
      "dispMbrGradeList": [
        {
          "evtNo": "text",
          "expGradeGbCd": "text",
          "expTgtNo": "text"
        }
      ],
      "loltList": [
        {
          "evtNo": "text",
          "evtMgrpCd": "text",
          "aplyRnk": 1,
          "roltPayPnum": 1,
          "roltPrbl": 1,
          "payPoint": 1
        }
      ],
      "attenList": [
        {
          "evtNo": "text",
          "evtMgrpCd": "text",
          "aplyRnk": 1,
          "roltPayPnum": 1,
          "roltPrbl": 1,
          "payPoint": 1
        }
      ],
      "questList": [
        {
          "evtNo": "text",
          "questNo": "text",
          "questGbCd": 20,
          "questCont": "text",
          "questQestCnt": 1,
          "cawrCont": "text",
          "dupAnsYn": "text",
          "mdtyQuestYn": "text",
          "questExpltList": [
            {
              "evtNo": "text",
              "questNo": "text",
              "questExplNo": "text",
              "questExplCont": "text",
              "questBnrPathNm": "text",
              "questBnrFileNm": "text"
            }
          ]
        }
      ],
      "pmgdList": [
        {
          "evtNo": "text",
          "evtFvrSeq": "text",
          "winRnk": 1,
          "evtFvrTypCd": 10,
          "evtFvrTypNm": "text",
          "buyAmt": 1,
          "payMilg": 1,
          "evtGoodsNm": "text",
          "promoNo": "text",
          "goodsNo": "text",
          "payPnumCnt": 1,
          "pmgdAmt": 1,
          "winmnChrgYn": "text",
          "tuba": 1,
          "winWtpsCnt": 1,
          "etcDesc1": "text",
          "etcDesc2": "text",
          "etcDesc3": "text",
          "etcDesc4": "text",
          "etcDesc5": "text",
          "trgmnCount": 1,
          "doingYn": "text",
          "pcount": 1
        }
      ],
      "tmplRelInfoList": [
        {
          "evtNo": "text",
          "evtTmplRelNo": "text",
          "tmplNo": "text",
          "tmplDtlGbCd": "text",
          "tmplDtlCmpsCd": "text",
          "tmplDtlSeq": "text",
          "htmlFileCont": "text",
          "pcHtmlFileCont": "text",
          "etcWrtCont": "text",
          "wrtRtGbCd": "text",
          "listPrtCntCd": "text",
          "bkgrImgPathNm": "text",
          "bkgrImgFileNm": "text",
          "bbSharYn": "text"
        }
      ],
      "tmplDtlInfoList": [
        {
          "tmplNo": "text",
          "tmplDtlGbCd": 10,
          "tmplDtlSeq": "text",
          "tmplDtlCmpsCd": 11,
          "tmplPrioRnk": "text",
          "htmlFileCont": "text",
          "pcHtmlFileCont": "text"
        }
      ],
      "evtExpMsg": "text",
      "atndMtr": "text",
      "acdnUseYn": "text",
      "custCntrGdWrdCont": "text",
      "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
      "evtStrDtm": "2026-01-01T00:00:00.000Z",
      "evtEndDtm": "2026-01-01T00:00:00.000Z",
      "buyStrDtm": "2026-01-01T00:00:00.000Z",
      "buyEndDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyStrDtm": "2026-01-01T00:00:00.000Z",
      "sbscAplyEndDtm": "2026-01-01T00:00:00.000Z",
      "sbscPsbMinOrdAmt": 1,
      "siteNm": "text",
      "aplySites": [
        "{'data':'플래티어닷컴',key:'1'}"
      ]
    }
  ]
}

Process Event Notification Talk Send

get

Function Description

• Processes the sending of notification talk for the event.

---

Detailed Description

• Event No. (evtNo) is required.

• Sends a notification talk to winners who are paid a prize/mileage.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

Notification Talk Sent Successfully

No content

900

Notification Talk Send Failure

*/*

get/v1/marketing/eventMgmt/saveEventMgmtAlimTalkSendRequest

GET /api/bo/v1/marketing/eventMgmt/saveEventMgmtAlimTalkSendRequest?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Check Products in Ongoing Event

get

Function Description

• Checks whether a product is in an ongoing event.

---

Detailed Description

• Product No. (goodsNo) is required.

• Checks the product that is in an ongoing event.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNostringRequired

Product No.

Example: 10002671

Responses

200

Product Check Success

*/*

integer · int32Optional

900

Product Check Failure

*/*

get/v1/marketing/eventMgmt/giftCheckInProgress

GET /api/bo/v1/marketing/eventMgmt/giftCheckInProgress?goodsNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

1

Event Top Fixed Status

get

Function Description

• Checks the event top fixed status.

---

Detailed Description

• Event No. (evtNo) is required.

• Checks the status before setting the event to top fixed.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

Top Fixed Status Check Success

*/*

integer · int32Optional

900

Top Fixed Status Check Failure

*/*

get/v1/marketing/eventMgmt/getEventUprFixCnt

GET /api/bo/v1/marketing/eventMgmt/getEventUprFixCnt?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

1

Retrieve Send History List

get

Function Description

• Retrieves the send history list.

---

Detailed Description

• Event No. (evtNo) is required.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

sndMethCdstringOptional

Send Method Code (EV013)

Example: 01

pageIdxstringRequired

Current Page

Example: 1

rowsPerPagestringRequired

Rows per Page

Example: 10

Responses

200

List Retrieved Successfully

*/*

evtNostringOptional

Event No.

trgmnSeqstringOptional

Target Sequence No.

sndSeqstringOptional

Send Sequence No.

resndYnstringOptional

Resend Status

resndCausCdstringOptional

Resend Reason Code

sndDtmstringOptional

Send Date/Time

sndYnstringOptional

Sending Status

mbrNmstringOptional

Member Name

loginIdstringOptional

Member ID

emailAddrstringOptional

Email

aempIdstringOptional

Person in Charge ID

900

List Retrieval Failed

*/*

get/v1/marketing/eventMgmt/getEventSendList

GET /api/bo/v1/marketing/eventMgmt/getEventSendList?evtNo=text&pageIdx=text&rowsPerPage=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "evtNo": "text",
    "trgmnSeq": "text",
    "sndSeq": "text",
    "resndYn": "text",
    "resndCausCd": "text",
    "sndDtm": "text",
    "sndYn": "text",
    "mbrNm": "text",
    "loginId": "text",
    "emailAddr": "text",
    "aempId": "text"
  }
]

Retrieve Send History List Count

get

Function Description

• Retrieves the count of the send history list.

---

Detailed Description

• Event No. (evtNo) is required.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

sndMethCdstringRequired

Send Method Code (EV013)

Example: 01

Responses

200

List Count Retrieved Successfully

*/*

integer · int32Optional

900

List Count Retrieval Failed

*/*

get/v1/marketing/eventMgmt/getEventSendListCount

GET /api/bo/v1/marketing/eventMgmt/getEventSendListCount?evtNo=text&sndMethCd=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

1

Download Payment Management List Excel

get

Function Description

• Downloads the Payment Management list Excel file.

---

Detailed Description

• Event No. (evtNo) is required.

• Downloads the data of the Payment Management grid as Excel.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

Excel Download Successful

*/*

qryGbCdstringOptional

Personal Information Access Type Code (UR014) 10: View, 20: Excel Download, 30: Modify

Example: 20

indInfoQryCausstringOptional

Access Reason Content

Example: 환불처리작업

evtMgrpCdstring · enumOptional

Event Type Subcategory Code (EV002)

Example: 30Possible values:

trgmnSeqstringOptional

Target Sequence No.

evtFvrTypCdstring · enumOptional

Event Benefit Type Code (EV011)

Example: 10Possible values:

evtTrgmnGbCdstring · enumOptional

Event Target Classification Code (EV012)

Example: 04Possible values:

mbrNostringOptional

Member No.

winRnkinteger · int32Optional

Winning Rank

winCnclCausContstringOptional

Winning Cancellation Reason Content

evtNostringOptional

Event No.

waitRnkinteger · int32Optional

Waitlist Rank

intxinteger · int32Optional

Income Tax

citxinteger · int32Optional

Local Income Tax

ordSumAmtinteger · int32Optional

Total Order Amount

cfmOrdAmtnumberOptional

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.

tubaDptAmtnumberOptional

Tax Withholding Deposit Amount

deliHdcCdstring · enumOptional

Delivery Courier Company Code (LO005)

Example: 10Possible values:

deliInvNostringOptional

Delivery Tracking No.

mailSndCntinteger · int32Optional

Email Send Count

mailSndFailCntinteger · int32Optional

Email Send Failure Count

bbcNostringOptional

Post Number

lotCondSeqstringOptional

Drawing Condition Sequence No.

etcGftDlvpNostringOptional

Other Gift Delivery Address No.

paysYnstringOptional

Payment Status

mbrNmstringOptional

Member Name

loginIdstringOptional

Member ID

emailAddrstringOptional

Email

zipAddrstringOptional

Address

dtlAddrstringOptional

Detailed Address

cellNostringOptional

Full Mobile Phone Number

cellSctNostringOptional

Mobile Phone Prefix Code

cellTxnoNostringOptional

Mobile Phone Exchange Code

cellEndNostringOptional

Mobile Phone Last Digits

errorMessagestringOptional

Error Message

lotStatstringOptional

Winning Status

lotGbstringOptional

Winner Classification

waitGbstringOptional

Waitlist Type

realGoodsstringOptional

Physical Prize

realGoodsNmstringOptional

Physical Prize Name

pmgdSndDtstringOptional

Prize Dispatch Date

payDtstringOptional

Payment Date (Mileage/Coupon)

payMilgnumberOptional

Mileage

payPointstringOptional

Points

rcvmnNmstringOptional

Prize Recipient Name

deliZipNostringOptional

Prize Delivery Address Postal Code

deliZipAddrstringOptional

Prize Receiving Address

deliZipDtlAddrstringOptional

Prize Receiving Address

deliCellSctNostringOptional

Prize Delivery Address Mobile Phone Prefix

deliCellTxnoNostringOptional

Prize Delivery Address Mobile Phone Middle Digits

deliCellEndNostringOptional

Prize Delivery Address Mobile Phone Last Digits

pmgdAmtstringOptional

Prize Value

realPointstringOptional

Actual Points Paid

resndYnstringOptional

Resend Status

evtNmstringOptional

Event Name

aempIdstringOptional

Event Manager

aempNmstringOptional

Event Manager

startDatestringOptional

Entry Period Start Date

endDatestringOptional

Entry Period End Date

mbrSexGbstringOptional

Gender

mbrAgestringOptional

Age

buyAmtinteger · int64Optional

Purchase Amount

bbcContstringOptional

Comment Content

excpTrgmnYnstringOptional

Event Excluded Target Status

lgcMbrNostringOptional

Core System Member No.

deliMsgstringOptional

Delivery Message

comnFrdrEtcMethodstringOptional

Building Entrance Other Access Method

comnFrdrPwdstringOptional

Building Entrance Password

realCouponNmstringOptional

Coupon Name

trnsYnstringOptional

Transmission Status

evtFvrSeqstringOptional

Event Benefit Sequence No.

winmnChrgYnstringOptional

Winner Cost-Bearing Status

tubanumberOptional

Withholding Tax

promoNostringOptional

Coupon No.

mbrGradeCdstringOptional

Member Grade Code

tubaEnterYnstringOptional

Tax and Public Dues Payment Status

goodsGiftsNmstringOptional

Gift Item

changePossibleYnstringOptional

Changeable Status

arrSndMethCdstringOptional

Sending Method Type Code

arrSndMethNmstringOptional

Sending Method Type Code

sbscAplyDtmstring · date-timeOptional

Application Date/Time

wtpsSltDtmstring · date-timeOptional

Waitlist Selection Date/Time

winDtmstring · date-timeOptional

Winning Date/Time

winCnclDtmstring · date-timeOptional

Winning Cancellation Date/Time

myCertiDtmstring · date-timeOptional

Identity Verification Date/Time

tubaDptDtmstring · date-timeOptional

Tax Withholding Deposit Date/Time

buyDtmstring · date-timeOptional

Purchase Date and Time

paysDtmstring · date-timeOptional

Payment Date/Time

buyStrDtmstring · date-timeOptional

Purchase Period Start Date/Time

buyEndDtmstring · date-timeOptional

Purchase Period End Date/Time

sbscPsbMinOrdAmtnumberOptional

Minimum Order Payment Amount for Entry

stafYnstringOptional

Employee Status

lotTypestringOptional

Request Type

mbrYnstringOptional

Member Existence Status

lotYnstringOptional

Winning Status

900

Excel Download Failed

*/*

get/v1/marketing/eventMgmt/getEventPayMgmtTrgmnInfoListExcelDownload

GET /api/bo/v1/marketing/eventMgmt/getEventPayMgmtTrgmnInfoListExcelDownload?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "qryGbCd": 20,
    "indInfoQryCaus": "환불처리작업",
    "evtMgrpCd": 30,
    "trgmnSeq": "text",
    "evtFvrTypCd": 10,
    "evtTrgmnGbCd": "04",
    "mbrNo": "text",
    "winRnk": 1,
    "winCnclCausCont": "text",
    "evtNo": "text",
    "waitRnk": 1,
    "intx": 1,
    "citx": 1,
    "ordSumAmt": 1,
    "cfmOrdAmt": 1,
    "evtSbscPathCd": "text",
    "tubaBankCd": "text",
    "tubaDepositorNm": "text",
    "tubaVirActnNo": "text",
    "tubaDptAmt": 1,
    "deliHdcCd": 10,
    "deliInvNo": "text",
    "mailSndCnt": 1,
    "mailSndFailCnt": 1,
    "bbcNo": "text",
    "lotCondSeq": "text",
    "etcGftDlvpNo": "text",
    "paysYn": "text",
    "mbrNm": "text",
    "loginId": "text",
    "emailAddr": "text",
    "zipAddr": "text",
    "dtlAddr": "text",
    "cellNo": "text",
    "cellSctNo": "text",
    "cellTxnoNo": "text",
    "cellEndNo": "text",
    "errorMessage": "text",
    "lotStat": "text",
    "lotGb": "text",
    "waitGb": "text",
    "realGoods": "text",
    "realGoodsNm": "text",
    "pmgdSndDt": "text",
    "payDt": "text",
    "payMilg": 1,
    "payPoint": "text",
    "rcvmnNm": "text",
    "deliZipNo": "text",
    "deliZipAddr": "text",
    "deliZipDtlAddr": "text",
    "deliCellSctNo": "text",
    "deliCellTxnoNo": "text",
    "deliCellEndNo": "text",
    "pmgdAmt": "text",
    "realPoint": "text",
    "resndYn": "text",
    "evtNm": "text",
    "aempId": "text",
    "aempNm": "text",
    "startDate": "text",
    "endDate": "text",
    "mbrSexGb": "text",
    "mbrAge": "text",
    "buyAmt": 1,
    "bbcCont": "text",
    "excpTrgmnYn": "text",
    "lgcMbrNo": "text",
    "deliMsg": "text",
    "comnFrdrEtcMethod": "text",
    "comnFrdrPwd": "text",
    "realCouponNm": "text",
    "trnsYn": "text",
    "evtFvrSeq": "text",
    "winmnChrgYn": "text",
    "tuba": 1,
    "promoNo": "text",
    "mbrGradeCd": "text",
    "tubaEnterYn": "text",
    "goodsGiftsNm": "text",
    "changePossibleYn": "text",
    "arrSndMethCd": "text",
    "arrSndMethNm": "text",
    "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
    "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
    "winDtm": "2026-01-01T00:00:00.000Z",
    "winCnclDtm": "2026-01-01T00:00:00.000Z",
    "myCertiDtm": "2026-01-01T00:00:00.000Z",
    "tubaDptDtm": "2026-01-01T00:00:00.000Z",
    "buyDtm": "2026-01-01T00:00:00.000Z",
    "paysDtm": "2026-01-01T00:00:00.000Z",
    "buyStrDtm": "2026-01-01T00:00:00.000Z",
    "buyEndDtm": "2026-01-01T00:00:00.000Z",
    "sbscPsbMinOrdAmt": 1,
    "stafYn": "text",
    "lotType": "text",
    "mbrYn": "text",
    "lotYn": "text"
  }
]

Retrieve Event Scope Site List

get

Function Description

• Retrieves the Event Scope site list.

---

Detailed Description

• Event No. (evtNo) is required.

• Retrieves the applicable scope site for the event via the evtNo parameter.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

List Retrieved Successfully

*/*

evtNostringOptional

Event No.

custFvrAplyGbCdstring · enumOptional

Customer Benefit Application Type Code (EV008)

Example: 10Possible values:

custFvrAplyTypCdstring · enumOptional

Customer Benefit Application Category Code (EV009)

Example: 10Possible values:

fvrTgtNostringOptional

Benefit Target No.

siteNmstringOptional

Site Name

siteDomstringOptional

Site Domain

applyContstringOptional

Application Details

900

List Retrieval Failed

*/*

get/v1/marketing/eventMgmt/getEventMgmtApplySiteList

GET /api/bo/v1/marketing/eventMgmt/getEventMgmtApplySiteList?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "evtNo": "text",
    "custFvrAplyGbCd": 10,
    "custFvrAplyTypCd": 10,
    "fvrTgtNo": "text",
    "siteNm": "text",
    "siteDom": "text",
    "applyCont": "text"
  }
]

Retrieve Event Scope Site List Count

get

Function Description

• Retrieves the count of the Event Scope site list.

---

Detailed Description

• Event No. (evtNo) is required.

• Retrieves the count of the applicable scope site list for the event via the evtNo parameter.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

List Count Retrieved Successfully

*/*

integer · int32Optional

900

List Count Retrieval Failed

*/*

get/v1/marketing/eventMgmt/getEventMgmtApplySiteListCount

GET /api/bo/v1/marketing/eventMgmt/getEventMgmtApplySiteListCount?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

1

Retrieve Event Target Member Winner Count

get

Function Description

• Retrieves the winner count of the event target members.

---

Detailed Description

• Event No. (evtNo) is required.

• Retrieves the winner count of target members for the event via the evtNo parameter.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

Winner Count Retrieval Success

*/*

integer · int32Optional

900

Winner Count Retrieval Failure

*/*

get/v1/marketing/eventMgmt/getEventLotMgmtWinnerMbrCount

GET /api/bo/v1/marketing/eventMgmt/getEventLotMgmtWinnerMbrCount?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

1

Retrieve Event Target Member Waitlist=>Winner Count

get

Function Description

• Retrieves the waitlist=>winner count of the event target members.

---

Detailed Description

• Event No. (evtNo) is required.

• Retrieves the waitlist=>winner count of target members for the event via the evtNo parameter.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

Waitlist=>Winner Count Retrieval Success

*/*

integer · int32Optional

900

Waitlist=>Winner Count Retrieval Failure

*/*

get/v1/marketing/eventMgmt/getEventLotMgmtWaitWinnerMbrCount

GET /api/bo/v1/marketing/eventMgmt/getEventLotMgmtWaitWinnerMbrCount?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

1

Retrieve Event Target Member Waitlist Count

get

Function Description

• Retrieves the waitlist count of the event target members.

---

Detailed Description

• Event No. (evtNo) is required.

• Retrieves the waitlist count of target members for the event via the evtNo parameter.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

Waitlist Count Retrieval Success

*/*

integer · int32Optional

900

Waitlist Count Retrieval Failure

*/*

get/v1/marketing/eventMgmt/getEventLotMgmtWaitMbrCount

GET /api/bo/v1/marketing/eventMgmt/getEventLotMgmtWaitMbrCount?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

1

Download Drawing Management List Excel

get

Function Description

• Downloads the Drawing Management list Excel file.

---

Detailed Description

• Event No. (evtNo) is required.

• Downloads the data of the Drawing Management grid as Excel.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

Excel Download Successful

*/*

qryGbCdstringOptional

Personal Information Access Type Code (UR014) 10: View, 20: Excel Download, 30: Modify

Example: 20

indInfoQryCausstringOptional

Access Reason Content

Example: 환불처리작업

evtMgrpCdstring · enumOptional

Event Type Subcategory Code (EV002)

Example: 30Possible values:

trgmnSeqstringOptional

Target Sequence No.

evtFvrTypCdstring · enumOptional

Event Benefit Type Code (EV011)

Example: 10Possible values:

evtTrgmnGbCdstring · enumOptional

Event Target Classification Code (EV012)

Example: 04Possible values:

mbrNostringOptional

Member No.

winRnkinteger · int32Optional

Winning Rank

winCnclCausContstringOptional

Winning Cancellation Reason Content

evtNostringOptional

Event No.

waitRnkinteger · int32Optional

Waitlist Rank

intxinteger · int32Optional

Income Tax

citxinteger · int32Optional

Local Income Tax

ordSumAmtinteger · int32Optional

Total Order Amount

cfmOrdAmtnumberOptional

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.

tubaDptAmtnumberOptional

Tax Withholding Deposit Amount

deliHdcCdstring · enumOptional

Delivery Courier Company Code (LO005)

Example: 10Possible values:

deliInvNostringOptional

Delivery Tracking No.

mailSndCntinteger · int32Optional

Email Send Count

mailSndFailCntinteger · int32Optional

Email Send Failure Count

bbcNostringOptional

Post Number

lotCondSeqstringOptional

Drawing Condition Sequence No.

etcGftDlvpNostringOptional

Other Gift Delivery Address No.

paysYnstringOptional

Payment Status

mbrNmstringOptional

Member Name

loginIdstringOptional

Member ID

emailAddrstringOptional

Email

zipAddrstringOptional

Address

dtlAddrstringOptional

Detailed Address

cellNostringOptional

Full Mobile Phone Number

cellSctNostringOptional

Mobile Phone Prefix Code

cellTxnoNostringOptional

Mobile Phone Exchange Code

cellEndNostringOptional

Mobile Phone Last Digits

errorMessagestringOptional

Error Message

lotStatstringOptional

Winning Status

lotGbstringOptional

Winner Classification

waitGbstringOptional

Waitlist Type

realGoodsstringOptional

Physical Prize

realGoodsNmstringOptional

Physical Prize Name

pmgdSndDtstringOptional

Prize Dispatch Date

payDtstringOptional

Payment Date (Mileage/Coupon)

payMilgnumberOptional

Mileage

payPointstringOptional

Points

rcvmnNmstringOptional

Prize Recipient Name

deliZipNostringOptional

Prize Delivery Address Postal Code

deliZipAddrstringOptional

Prize Receiving Address

deliZipDtlAddrstringOptional

Prize Receiving Address

deliCellSctNostringOptional

Prize Delivery Address Mobile Phone Prefix

deliCellTxnoNostringOptional

Prize Delivery Address Mobile Phone Middle Digits

deliCellEndNostringOptional

Prize Delivery Address Mobile Phone Last Digits

pmgdAmtstringOptional

Prize Value

realPointstringOptional

Actual Points Paid

resndYnstringOptional

Resend Status

evtNmstringOptional

Event Name

aempIdstringOptional

Event Manager

aempNmstringOptional

Event Manager

startDatestringOptional

Entry Period Start Date

endDatestringOptional

Entry Period End Date

mbrSexGbstringOptional

Gender

mbrAgestringOptional

Age

buyAmtinteger · int64Optional

Purchase Amount

bbcContstringOptional

Comment Content

excpTrgmnYnstringOptional

Event Excluded Target Status

lgcMbrNostringOptional

Core System Member No.

deliMsgstringOptional

Delivery Message

comnFrdrEtcMethodstringOptional

Building Entrance Other Access Method

comnFrdrPwdstringOptional

Building Entrance Password

realCouponNmstringOptional

Coupon Name

trnsYnstringOptional

Transmission Status

evtFvrSeqstringOptional

Event Benefit Sequence No.

winmnChrgYnstringOptional

Winner Cost-Bearing Status

tubanumberOptional

Withholding Tax

promoNostringOptional

Coupon No.

mbrGradeCdstringOptional

Member Grade Code

tubaEnterYnstringOptional

Tax and Public Dues Payment Status

goodsGiftsNmstringOptional

Gift Item

changePossibleYnstringOptional

Changeable Status

arrSndMethCdstringOptional

Sending Method Type Code

arrSndMethNmstringOptional

Sending Method Type Code

sbscAplyDtmstring · date-timeOptional

Application Date/Time

wtpsSltDtmstring · date-timeOptional

Waitlist Selection Date/Time

winDtmstring · date-timeOptional

Winning Date/Time

winCnclDtmstring · date-timeOptional

Winning Cancellation Date/Time

myCertiDtmstring · date-timeOptional

Identity Verification Date/Time

tubaDptDtmstring · date-timeOptional

Tax Withholding Deposit Date/Time

buyDtmstring · date-timeOptional

Purchase Date and Time

paysDtmstring · date-timeOptional

Payment Date/Time

buyStrDtmstring · date-timeOptional

Purchase Period Start Date/Time

buyEndDtmstring · date-timeOptional

Purchase Period End Date/Time

sbscPsbMinOrdAmtnumberOptional

Minimum Order Payment Amount for Entry

stafYnstringOptional

Employee Status

lotTypestringOptional

Request Type

mbrYnstringOptional

Member Existence Status

lotYnstringOptional

Winning Status

900

Excel Download Failed

*/*

get/v1/marketing/eventMgmt/getEventLotMgmtTrgmnInfoListExcelDownload

GET /api/bo/v1/marketing/eventMgmt/getEventLotMgmtTrgmnInfoListExcelDownload?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "qryGbCd": 20,
    "indInfoQryCaus": "환불처리작업",
    "evtMgrpCd": 30,
    "trgmnSeq": "text",
    "evtFvrTypCd": 10,
    "evtTrgmnGbCd": "04",
    "mbrNo": "text",
    "winRnk": 1,
    "winCnclCausCont": "text",
    "evtNo": "text",
    "waitRnk": 1,
    "intx": 1,
    "citx": 1,
    "ordSumAmt": 1,
    "cfmOrdAmt": 1,
    "evtSbscPathCd": "text",
    "tubaBankCd": "text",
    "tubaDepositorNm": "text",
    "tubaVirActnNo": "text",
    "tubaDptAmt": 1,
    "deliHdcCd": 10,
    "deliInvNo": "text",
    "mailSndCnt": 1,
    "mailSndFailCnt": 1,
    "bbcNo": "text",
    "lotCondSeq": "text",
    "etcGftDlvpNo": "text",
    "paysYn": "text",
    "mbrNm": "text",
    "loginId": "text",
    "emailAddr": "text",
    "zipAddr": "text",
    "dtlAddr": "text",
    "cellNo": "text",
    "cellSctNo": "text",
    "cellTxnoNo": "text",
    "cellEndNo": "text",
    "errorMessage": "text",
    "lotStat": "text",
    "lotGb": "text",
    "waitGb": "text",
    "realGoods": "text",
    "realGoodsNm": "text",
    "pmgdSndDt": "text",
    "payDt": "text",
    "payMilg": 1,
    "payPoint": "text",
    "rcvmnNm": "text",
    "deliZipNo": "text",
    "deliZipAddr": "text",
    "deliZipDtlAddr": "text",
    "deliCellSctNo": "text",
    "deliCellTxnoNo": "text",
    "deliCellEndNo": "text",
    "pmgdAmt": "text",
    "realPoint": "text",
    "resndYn": "text",
    "evtNm": "text",
    "aempId": "text",
    "aempNm": "text",
    "startDate": "text",
    "endDate": "text",
    "mbrSexGb": "text",
    "mbrAge": "text",
    "buyAmt": 1,
    "bbcCont": "text",
    "excpTrgmnYn": "text",
    "lgcMbrNo": "text",
    "deliMsg": "text",
    "comnFrdrEtcMethod": "text",
    "comnFrdrPwd": "text",
    "realCouponNm": "text",
    "trnsYn": "text",
    "evtFvrSeq": "text",
    "winmnChrgYn": "text",
    "tuba": 1,
    "promoNo": "text",
    "mbrGradeCd": "text",
    "tubaEnterYn": "text",
    "goodsGiftsNm": "text",
    "changePossibleYn": "text",
    "arrSndMethCd": "text",
    "arrSndMethNm": "text",
    "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
    "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
    "winDtm": "2026-01-01T00:00:00.000Z",
    "winCnclDtm": "2026-01-01T00:00:00.000Z",
    "myCertiDtm": "2026-01-01T00:00:00.000Z",
    "tubaDptDtm": "2026-01-01T00:00:00.000Z",
    "buyDtm": "2026-01-01T00:00:00.000Z",
    "paysDtm": "2026-01-01T00:00:00.000Z",
    "buyStrDtm": "2026-01-01T00:00:00.000Z",
    "buyEndDtm": "2026-01-01T00:00:00.000Z",
    "sbscPsbMinOrdAmt": 1,
    "stafYn": "text",
    "lotType": "text",
    "mbrYn": "text",
    "lotYn": "text"
  }
]

Download Entry Management List Excel

get

Function Description

• Downloads the Entry Management list Excel file.

---

Detailed Description

• Event No. (evtNo) is required.

• Downloads the data of the Entry Management grid as Excel.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

Excel Download Successful

*/*

qryGbCdstringOptional

Personal Information Access Type Code (UR014) 10: View, 20: Excel Download, 30: Modify

Example: 20

indInfoQryCausstringOptional

Access Reason Content

Example: 환불처리작업

evtMgrpCdstring · enumOptional

Event Type Subcategory Code (EV002)

Example: 30Possible values:

trgmnSeqstringOptional

Target Sequence No.

evtFvrTypCdstring · enumOptional

Event Benefit Type Code (EV011)

Example: 10Possible values:

evtTrgmnGbCdstring · enumOptional

Event Target Classification Code (EV012)

Example: 04Possible values:

mbrNostringOptional

Member No.

winRnkinteger · int32Optional

Winning Rank

winCnclCausContstringOptional

Winning Cancellation Reason Content

evtNostringOptional

Event No.

waitRnkinteger · int32Optional

Waitlist Rank

intxinteger · int32Optional

Income Tax

citxinteger · int32Optional

Local Income Tax

ordSumAmtinteger · int32Optional

Total Order Amount

cfmOrdAmtnumberOptional

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.

tubaDptAmtnumberOptional

Tax Withholding Deposit Amount

deliHdcCdstring · enumOptional

Delivery Courier Company Code (LO005)

Example: 10Possible values:

deliInvNostringOptional

Delivery Tracking No.

mailSndCntinteger · int32Optional

Email Send Count

mailSndFailCntinteger · int32Optional

Email Send Failure Count

bbcNostringOptional

Post Number

lotCondSeqstringOptional

Drawing Condition Sequence No.

etcGftDlvpNostringOptional

Other Gift Delivery Address No.

paysYnstringOptional

Payment Status

mbrNmstringOptional

Member Name

loginIdstringOptional

Member ID

emailAddrstringOptional

Email

zipAddrstringOptional

Address

dtlAddrstringOptional

Detailed Address

cellNostringOptional

Full Mobile Phone Number

cellSctNostringOptional

Mobile Phone Prefix Code

cellTxnoNostringOptional

Mobile Phone Exchange Code

cellEndNostringOptional

Mobile Phone Last Digits

errorMessagestringOptional

Error Message

lotStatstringOptional

Winning Status

lotGbstringOptional

Winner Classification

waitGbstringOptional

Waitlist Type

realGoodsstringOptional

Physical Prize

realGoodsNmstringOptional

Physical Prize Name

pmgdSndDtstringOptional

Prize Dispatch Date

payDtstringOptional

Payment Date (Mileage/Coupon)

payMilgnumberOptional

Mileage

payPointstringOptional

Points

rcvmnNmstringOptional

Prize Recipient Name

deliZipNostringOptional

Prize Delivery Address Postal Code

deliZipAddrstringOptional

Prize Receiving Address

deliZipDtlAddrstringOptional

Prize Receiving Address

deliCellSctNostringOptional

Prize Delivery Address Mobile Phone Prefix

deliCellTxnoNostringOptional

Prize Delivery Address Mobile Phone Middle Digits

deliCellEndNostringOptional

Prize Delivery Address Mobile Phone Last Digits

pmgdAmtstringOptional

Prize Value

realPointstringOptional

Actual Points Paid

resndYnstringOptional

Resend Status

evtNmstringOptional

Event Name

aempIdstringOptional

Event Manager

aempNmstringOptional

Event Manager

startDatestringOptional

Entry Period Start Date

endDatestringOptional

Entry Period End Date

mbrSexGbstringOptional

Gender

mbrAgestringOptional

Age

buyAmtinteger · int64Optional

Purchase Amount

bbcContstringOptional

Comment Content

excpTrgmnYnstringOptional

Event Excluded Target Status

lgcMbrNostringOptional

Core System Member No.

deliMsgstringOptional

Delivery Message

comnFrdrEtcMethodstringOptional

Building Entrance Other Access Method

comnFrdrPwdstringOptional

Building Entrance Password

realCouponNmstringOptional

Coupon Name

trnsYnstringOptional

Transmission Status

evtFvrSeqstringOptional

Event Benefit Sequence No.

winmnChrgYnstringOptional

Winner Cost-Bearing Status

tubanumberOptional

Withholding Tax

promoNostringOptional

Coupon No.

mbrGradeCdstringOptional

Member Grade Code

tubaEnterYnstringOptional

Tax and Public Dues Payment Status

goodsGiftsNmstringOptional

Gift Item

changePossibleYnstringOptional

Changeable Status

arrSndMethCdstringOptional

Sending Method Type Code

arrSndMethNmstringOptional

Sending Method Type Code

sbscAplyDtmstring · date-timeOptional

Application Date/Time

wtpsSltDtmstring · date-timeOptional

Waitlist Selection Date/Time

winDtmstring · date-timeOptional

Winning Date/Time

winCnclDtmstring · date-timeOptional

Winning Cancellation Date/Time

myCertiDtmstring · date-timeOptional

Identity Verification Date/Time

tubaDptDtmstring · date-timeOptional

Tax Withholding Deposit Date/Time

buyDtmstring · date-timeOptional

Purchase Date and Time

paysDtmstring · date-timeOptional

Payment Date/Time

buyStrDtmstring · date-timeOptional

Purchase Period Start Date/Time

buyEndDtmstring · date-timeOptional

Purchase Period End Date/Time

sbscPsbMinOrdAmtnumberOptional

Minimum Order Payment Amount for Entry

stafYnstringOptional

Employee Status

lotTypestringOptional

Request Type

mbrYnstringOptional

Member Existence Status

lotYnstringOptional

Winning Status

900

Excel Download Failed

*/*

get/v1/marketing/eventMgmt/getEventAplctMgmtTrgmnInfoListExcelDownload

GET /api/bo/v1/marketing/eventMgmt/getEventAplctMgmtTrgmnInfoListExcelDownload?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "qryGbCd": 20,
    "indInfoQryCaus": "환불처리작업",
    "evtMgrpCd": 30,
    "trgmnSeq": "text",
    "evtFvrTypCd": 10,
    "evtTrgmnGbCd": "04",
    "mbrNo": "text",
    "winRnk": 1,
    "winCnclCausCont": "text",
    "evtNo": "text",
    "waitRnk": 1,
    "intx": 1,
    "citx": 1,
    "ordSumAmt": 1,
    "cfmOrdAmt": 1,
    "evtSbscPathCd": "text",
    "tubaBankCd": "text",
    "tubaDepositorNm": "text",
    "tubaVirActnNo": "text",
    "tubaDptAmt": 1,
    "deliHdcCd": 10,
    "deliInvNo": "text",
    "mailSndCnt": 1,
    "mailSndFailCnt": 1,
    "bbcNo": "text",
    "lotCondSeq": "text",
    "etcGftDlvpNo": "text",
    "paysYn": "text",
    "mbrNm": "text",
    "loginId": "text",
    "emailAddr": "text",
    "zipAddr": "text",
    "dtlAddr": "text",
    "cellNo": "text",
    "cellSctNo": "text",
    "cellTxnoNo": "text",
    "cellEndNo": "text",
    "errorMessage": "text",
    "lotStat": "text",
    "lotGb": "text",
    "waitGb": "text",
    "realGoods": "text",
    "realGoodsNm": "text",
    "pmgdSndDt": "text",
    "payDt": "text",
    "payMilg": 1,
    "payPoint": "text",
    "rcvmnNm": "text",
    "deliZipNo": "text",
    "deliZipAddr": "text",
    "deliZipDtlAddr": "text",
    "deliCellSctNo": "text",
    "deliCellTxnoNo": "text",
    "deliCellEndNo": "text",
    "pmgdAmt": "text",
    "realPoint": "text",
    "resndYn": "text",
    "evtNm": "text",
    "aempId": "text",
    "aempNm": "text",
    "startDate": "text",
    "endDate": "text",
    "mbrSexGb": "text",
    "mbrAge": "text",
    "buyAmt": 1,
    "bbcCont": "text",
    "excpTrgmnYn": "text",
    "lgcMbrNo": "text",
    "deliMsg": "text",
    "comnFrdrEtcMethod": "text",
    "comnFrdrPwd": "text",
    "realCouponNm": "text",
    "trnsYn": "text",
    "evtFvrSeq": "text",
    "winmnChrgYn": "text",
    "tuba": 1,
    "promoNo": "text",
    "mbrGradeCd": "text",
    "tubaEnterYn": "text",
    "goodsGiftsNm": "text",
    "changePossibleYn": "text",
    "arrSndMethCd": "text",
    "arrSndMethNm": "text",
    "sbscAplyDtm": "2026-01-01T00:00:00.000Z",
    "wtpsSltDtm": "2026-01-01T00:00:00.000Z",
    "winDtm": "2026-01-01T00:00:00.000Z",
    "winCnclDtm": "2026-01-01T00:00:00.000Z",
    "myCertiDtm": "2026-01-01T00:00:00.000Z",
    "tubaDptDtm": "2026-01-01T00:00:00.000Z",
    "buyDtm": "2026-01-01T00:00:00.000Z",
    "paysDtm": "2026-01-01T00:00:00.000Z",
    "buyStrDtm": "2026-01-01T00:00:00.000Z",
    "buyEndDtm": "2026-01-01T00:00:00.000Z",
    "sbscPsbMinOrdAmt": 1,
    "stafYn": "text",
    "lotType": "text",
    "mbrYn": "text",
    "lotYn": "text"
  }
]

Generate Event Number

get

Function Description

• An API that generates an event number.

---

Detailed Description

• No required values.

• Generates an event number when opening the event registration popup.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Event Number Generation Success

*/*

integer · int32Optional

900

Event Number Generation Failure

*/*

get/v1/marketing/eventMgmt/getCreateEvtNo

GET /api/bo/v1/marketing/eventMgmt/getCreateEvtNo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

1

Entry Management Search Tab - Download List Excel

get

Function Description

• Downloads the list Excel file from the Entry Management search tab.

---

Detailed Description

• No required values.

• Downloads the Entry Management grid list as Excel.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

Excel Download Successful

No content

900

Excel Download Failed

*/*

get/v1/marketing/eventMgmt/excelDownTrgmnList

GET /api/bo/v1/marketing/eventMgmt/excelDownTrgmnList?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Payment Management Search Tab - Download List Excel

get

Function Description

• Downloads the list Excel file from the Payment Management search tab.

---

Detailed Description

• No required values.

• Downloads the Payment Management grid list as Excel.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

Excel Download Successful

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

Excel Download Failed

*/*

get/v1/marketing/eventMgmt/excelDownPayList

GET /api/bo/v1/marketing/eventMgmt/excelDownPayList?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Drawing Management Search Tab - Download List Excel

get

Function Description

• Downloads the list Excel file from the Drawing Management search tab.

---

Detailed Description

• No required values.

• Downloads the Drawing Management grid list as Excel.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

evtNostringRequired

Event No.

Example: 791

Responses

200

Excel Download Successful

No content

900

Excel Download Failed

*/*

get/v1/marketing/eventMgmt/excelDownLotList

GET /api/bo/v1/marketing/eventMgmt/excelDownLotList?evtNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content