> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/api-en/back-office-api-reference/members-bo-api/member-information-management.md).

# Member Information Management

## Modify Business Address

> \## Function Description\
> \* Modifies the business address of the business member.\
> \---\
> \## Detailed Description\
> \* Modifies the business address of the business member.\
> \* Adds a member information change history entry when the business address is modified.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/updateBmanAddress":{"post":{"tags":["Member Information Management"],"summary":"Modify Business Address","description":"## Function Description\n* Modifies the business address of the business member.\n---\n## Detailed Description\n* Modifies the business address of the business member.\n* Adds a member information change history entry when the business address is modified.\n","operationId":"updateBmanAddress","parameters":[{"name":"request","in":"query","description":"Business Address Modification Request","required":true,"schema":{"type":"string","description":"MemberBusinessAddressChgRequest"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberBusinessAddressChgRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberBusinessAddressChgRequest":{"type":"object","description":"Business Address Save Request","properties":{"mbrNo":{"type":"string","description":"Member No.","minLength":1},"bplcZipNo":{"type":"string","description":"Business Postal Code","minLength":1},"bplcZipAddr":{"type":"string","description":"Business Postal Address","minLength":1},"bplcDtlAddr":{"type":"string","description":"Business Address","minLength":1}},"required":["bplcDtlAddr","bplcZipAddr","bplcZipNo","mbrNo"]},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Register Refund Account

> \## Function Description\
> \* Registers the member's refund account.\
> \---\
> \## Detailed Description\
> \---\
> \## Notes\
> \* The account holder name must match the member's name.\
> \* Account verification must be completed.\
> \* Required value list\
> &#x20;  \* Account No.\
> &#x20;  \* Bank Code\
> &#x20;  \* Account Verification Status<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/saveMemberRefundActn":{"post":{"tags":["Member Information Management"],"summary":"Register Refund Account","description":"## Function Description\n* Registers the member's refund account.\n---\n## Detailed Description\n---\n## Notes\n* The account holder name must match the member's name.\n* Account verification must be completed.\n* Required value list\n   * Account No.\n   * Bank Code\n   * Account Verification Status\n","operationId":"saveMemberRefundActn","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberRefundActnRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberRefundActnRequest":{"type":"object","description":"Refund Account Registration Request","properties":{"mbrNo":{"type":"string","description":"Member No."},"rfdBankCd":{"type":"string","description":"Bank Code (OM026)"},"rfdActnNo":{"type":"string","description":"Account Number"},"rfdActnDepositorNm":{"type":"string","description":"Refund Account Holder"},"rfdActnCertiYn":{"type":"string","description":"Account Verification Status"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Save/Modify/Delete Member Delivery Address

> \## Function Description\
> \* Saves, modifies, or deletes a delivery address.\
> \---\
> \## Detailed Description\
> \* Saves the member's delivery address.\
> \* Modifies the member's delivery address.\
> \* Deletes the member's delivery address.\
> \---\
> \## Revision History\
> \* Release v1.06\_231218: Delivery addresses can be registered up to the Reference 1 value of common code ST017.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/saveMemberDelivery":{"post":{"tags":["Member Information Management"],"summary":"Save/Modify/Delete Member Delivery Address","description":"## Function Description\n* Saves, modifies, or deletes a delivery address.\n---\n## Detailed Description\n* Saves the member's delivery address.\n* Modifies the member's delivery address.\n* Deletes the member's delivery address.\n---\n## Revision History\n* Release v1.06_231218: Delivery addresses can be registered up to the Reference 1 value of common code ST017.\n","operationId":"saveMemberDelivery","parameters":[{"name":"saveMemberDelivery","in":"query","description":"Member Delivery Address Save Request","required":true,"schema":{"type":"string","description":"SaveMemberDelivery"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveMemberDelivery"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"SaveMemberDelivery":{"type":"object","description":"Member Delivery Address Save and Delete Request","properties":{"realGridCUD":{"$ref":"#/components/schemas/RealGridCUDRequestEtMbrDlvpInfo"}}},"RealGridCUDRequestEtMbrDlvpInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/EtMbrDlvpInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/EtMbrDlvpInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/EtMbrDlvpInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/EtMbrDlvpInfo"}}}},"EtMbrDlvpInfo":{"type":"object","description":"Member Delivery Address Information Entity","properties":{"mbrNo":{"type":"string","description":"Member No."},"mbrDlvpSeq":{"type":"string","description":"Member Delivery Address Sequence No."},"dlvpNm":{"type":"string","description":"Delivery Address Name"},"rcvmnNm":{"type":"string","description":"Recipient Name"},"baseDlvpYn":{"type":"string","description":"Default Delivery Address Status"},"zipNoSeq":{"type":"integer","format":"int64","description":"Postal Code Sequence No."},"zipNo":{"type":"string","description":"Postal Code"},"zipAddr":{"type":"string","description":"Postal Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"emailAddr":{"type":"string","description":"Email Address"},"cellSctNo":{"type":"string","description":"Mobile Phone Prefix Code"},"cellTxnoNo":{"type":"string","description":"Mobile Phone Exchange Code"},"cellEndNo":{"type":"string","description":"Mobile Phone Last Digits"},"telRgnNo":{"type":"string","description":"Phone Area Code"},"telTxnoNo":{"type":"string","description":"Phone Exchange Code"},"telEndNo":{"type":"string","description":"Phone Last Digits"},"deliMsgCd":{"type":"string","description":"Delivery Message Code (ME039)"},"deliMsg":{"type":"string","description":"Delivery Message"},"comnFrdrCogoMethodCd":{"type":"string","description":"Common Entrance Access Method Code (ME040)"},"comnFrdrEtcMethod":{"type":"string","description":"Other Common Entrance Access Method"},"comnFrdrPwd":{"type":"string","description":"Common Entrance Password"},"useYn":{"type":"string","description":"Usage Status"},"userSortSeq":{"type":"string","description":"User Sort Order"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Register Employee

> \## Function Description\
> \* Registers a member as an employee.\
> \---\
> \## Detailed Description\
> \* Registers a member as an employee.\
> \* The same employee number cannot be registered for the same company.\
> \---\
> \## Revision History\
> \* Release v1.03\_231106: \<br>\
> &#x20;  \* INSERT into the employee discount limit and employee discount limit history tables upon initial employee registration\
> &#x20;  \* UPDATE the USE\_YN value of the employee discount limit table to 'N' upon employee re-registration\
> &#x20;  \* When re-registering as an employee of a different company, fully exhaust the remaining employee discount limit of the existing company and INSERT into the new company's history table<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/modifyStaf":{"post":{"tags":["Member Information Management"],"summary":"Register Employee","description":"## Function Description\n* Registers a member as an employee.\n---\n## Detailed Description\n* Registers a member as an employee.\n* The same employee number cannot be registered for the same company.\n---\n## Revision History\n* Release v1.03_231106: <br>\n   * INSERT into the employee discount limit and employee discount limit history tables upon initial employee registration\n   * UPDATE the USE_YN value of the employee discount limit table to 'N' upon employee re-registration\n   * When re-registering as an employee of a different company, fully exhaust the remaining employee discount limit of the existing company and INSERT into the new company's history table\n","operationId":"modifyStaf","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberStafRegReqeust"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberStafRegReqeust":{"type":"object","description":"Employee Registration Request","properties":{"mbrNo":{"type":"string","description":"Member No."},"stafMgrNo":{"type":"string","description":"Employee No."},"comGbCd":{"type":"string","description":"Company Classification Code"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Save Member Contact Information

> \## Function Description\
> \* Saves the member's contact information.\
> \---\
> \## Detailed Description\
> \* Saves the member's contact information.\
> \* Member contact information\
> &#x20;  \* Email address\
> &#x20;  \* Phone number<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/memberUpdateContact":{"post":{"tags":["Member Information Management"],"summary":"Save Member Contact Information","description":"## Function Description\n* Saves the member's contact information.\n---\n## Detailed Description\n* Saves the member's contact information.\n* Member contact information\n   * Email address\n   * Phone number\n","operationId":"memberUpdateContact","parameters":[{"name":"request","in":"query","description":"Member Contact Information Save Request","required":true,"schema":{"type":"string","description":"MemberContactChgRequest"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberContactChgRequest"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberContactChgRequest":{"type":"object","description":"Member Contact Information Save Request","properties":{"mbrNo":{"type":"string","description":"Member No."},"emailAddr":{"type":"string","description":"Email Address"},"telRgnNo":{"type":"string","description":"Phone Area Code"},"telTxnoNo":{"type":"string","description":"Phone Exchange Code"},"telEndNo":{"type":"string","description":"Phone Last Digits"},"etMbrInfoChgHistList":{"type":"array","description":"Member Contact Information List","items":{"$ref":"#/components/schemas/EtMbrInfoChgHist"}}}},"EtMbrInfoChgHist":{"type":"object","description":"Member Information Change History Entity","properties":{"mbrInfoChgSeq":{"type":"string","description":"Member Information Change Sequence No."},"mbrNo":{"type":"string","description":"Member No."},"chgTgtTypCd":{"type":"string","description":"Change Target Type Code (ME004)"},"chgCont":{"type":"string","description":"Change Content"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Save Member Address

> \## Function Description\
> \* Saves the member's address.\
> \---\
> \## Detailed Description\
> \* Saves the address among the member's personal information.\
> \* Adds a member information change history entry when personal information is modified.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/memberUpdateAddress":{"post":{"tags":["Member Information Management"],"summary":"Save Member Address","description":"## Function Description\n* Saves the member's address.\n---\n## Detailed Description\n* Saves the address among the member's personal information.\n* Adds a member information change history entry when personal information is modified.\n","operationId":"memberUpdateAddress","parameters":[{"name":"request","in":"query","description":"Save Member Address Request","required":true,"schema":{"type":"string","description":"MemberAddressChgRequest"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberAddressChgRequest"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberAddressChgRequest":{"type":"object","description":"Save Member Address Request","properties":{"mbrNo":{"type":"string","description":"Member No."},"zipNoSeq":{"type":"integer","format":"int64","description":"Postal Code Sequence No."},"zipNo":{"type":"string","description":"Postal Code"},"zipAddr":{"type":"string","description":"Postal Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"nafrGbCd":{"type":"string","description":"Domestic 10, Overseas 20"},"etMbrInfoChgHist":{"$ref":"#/components/schemas/EtMbrInfoChgHist","description":"Member Information Change History Entity"}}},"EtMbrInfoChgHist":{"type":"object","description":"Member Information Change History Entity","properties":{"mbrInfoChgSeq":{"type":"string","description":"Member Information Change Sequence No."},"mbrNo":{"type":"string","description":"Member No."},"chgTgtTypCd":{"type":"string","description":"Change Target Type Code (ME004)"},"chgCont":{"type":"string","description":"Change Content"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Password Reset

> \## Function Description\
> \* Resets the password.\
> \---\
> \## Detailed Description\
> \* Resets the member's password.\
> \* When a customer loses their password, a randomly combined password is set and delivered to the member's registered phone number.\
> \* The temporary password is generated as a 10-character combination of uppercase letters, lowercase letters, and numbers.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/initializePassword":{"post":{"tags":["Member Information Management"],"summary":"Password Reset","description":"## Function Description\n* Resets the password.\n---\n## Detailed Description\n* Resets the member's password.\n* When a customer loses their password, a randomly combined password is set and delivered to the member's registered phone number.\n* The temporary password is generated as a 10-character combination of uppercase letters, lowercase letters, and numbers.\n","operationId":"initializePassword","parameters":[{"name":"request","in":"query","description":"Reset Password Request","required":true,"schema":{"type":"string","description":"MemberInitPwdRequest"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberInitPwdRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberInitPwdRequest":{"type":"object","description":"Reset Password Request","properties":{"loginId":{"type":"string","description":"Login ID"},"mbrNo":{"type":"string","description":"Member No."},"pwdIniCausCont":{"type":"string","description":"Password Reset Reason"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Consent History List

> \## Function Description\
> \* Retrieves the member's consent history list.\
> \---\
> \## Detailed Description\
> \* Retrieves the member's marketing consent history list.\
> \* A history entry accumulates each time the member changes their marketing consent.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v2/member/memberMgmt/getAgreeHistory":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Consent History List","description":"## Function Description\n* Retrieves the member's consent history list.\n---\n## Detailed Description\n* Retrieves the member's marketing consent history list.\n* A history entry accumulates each time the member changes their marketing consent.\n","operationId":"getAgreeHistory","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MemberDetailRequest"}},{"name":"MemberDetailRequest","in":"query","description":"Consent History List Retrieval Request","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseAgreeHistoryResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberDetailRequest":{"type":"object","description":"Member Detail Request","properties":{"mbrNo":{"type":"string","description":"Member No."},"mbrNoList":{"type":"array","description":"Member No. List","items":{"type":"string"}},"mbrNm":{"type":"string","description":"Member Name"},"loginId":{"type":"string","description":"Member Login ID"},"svcAgrTypCd":{"type":"string","description":"Service Consent Type Code (ME025)"},"lgcMbrNo":{"type":"string","description":"Core System Member No."},"authCheck":{"type":"boolean","description":"Conditional Masking Status"},"authYn":{"type":"string","description":"Masking Status"},"authTotalYn":{"type":"string","description":"Full Masking Status of Masked Data"},"mbrDlvpSeq":{"type":"string","description":"Member Delivery Address Sequence No."},"ordNo":{"type":"string","description":"Order No."}}},"RealGridListResponseAgreeHistoryResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/AgreeHistoryResponse"}}}},"AgreeHistoryResponse":{"type":"object","description":"Consent History List Retrieval Response","properties":{"siteNm":{"type":"string","description":"Site Name"},"svcAgrTypNm":{"type":"string","description":"Consent Type"},"agrYn":{"type":"string","description":"Consent Status"},"sysRegDtm":{"type":"string","description":"Change Date/Time"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Marketing/Service Consent List

> \## Function Description\
> \* Retrieves the member's marketing/service consent list.\
> \---\
> \## Detailed Description\
> \* Retrieves the count of the member's marketing/service consent list.\
> \* Consent list\
> &#x20;  \* SMS Consent\
> &#x20;  \* Email Consent\
> &#x20;  \* Push Notification Consent\
> \## Revision History\
> &#x20;  \* Release\_240125\_01: Added Kakao consent<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getServiceAgreeHist":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Marketing/Service Consent List","description":"## Function Description\n* Retrieves the member's marketing/service consent list.\n---\n## Detailed Description\n* Retrieves the count of the member's marketing/service consent list.\n* Consent list\n   * SMS Consent\n   * Email Consent\n   * Push Notification Consent\n## Revision History\n   * Release_240125_01: Added Kakao consent\n","operationId":"getServiceAgreeHist","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/ServiceAgreeHistRequest"}},{"name":"ServiceAgreeHistRequest","in":"query","description":"Marketing/Service Consent List Request","required":true,"schema":{"type":"string","description":"ServiceAgreeHistRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ServiceAgreeHistResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ServiceAgreeHistRequest":{"type":"object","description":"Marketing/Service Consent List Request","properties":{"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"mbrNm":{"type":"string","description":"Member Name"}}},"ServiceAgreeHistResponse":{"type":"object","description":"Marketing/Service Consent List Response","properties":{"siteNm":{"type":"string","description":"Site Name"},"smsRecvAgrYn":{"type":"string","description":"SMS Consent"},"emailRecvAgrYn":{"type":"string","description":"Email Consent"},"appPushAgrYn":{"type":"string","description":"Push Notification Consent"},"kakaoRecvAgrYn":{"type":"string","description":"Kakao Consent"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Marketing/Service Consent List Count

> \## Function Description\
> \* Retrieves the count of the member's marketing/service consent list.\
> \---\
> \## Detailed Description\
> \* Retrieves the count of the member's marketing/service consent list.\
> \* Consent list\
> &#x20;  \* SMS Consent\
> &#x20;  \* Email Consent\
> &#x20;  \* Push Notification Consent<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getServiceAgreeHistCount":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Marketing/Service Consent List Count","description":"## Function Description\n* Retrieves the count of the member's marketing/service consent list.\n---\n## Detailed Description\n* Retrieves the count of the member's marketing/service consent list.\n* Consent list\n   * SMS Consent\n   * Email Consent\n   * Push Notification Consent\n","operationId":"getServiceAgreeHistCount","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/ServiceAgreeHistRequest"}},{"name":"ServiceAgreeHistRequest","in":"query","description":"Marketing/Service Consent List Request","required":true,"schema":{"type":"string","description":"ServiceAgreeHistRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ServiceAgreeHistRequest":{"type":"object","description":"Marketing/Service Consent List Request","properties":{"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"mbrNm":{"type":"string","description":"Member Name"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Product Review List

> \## Function Description\
> \* Retrieves the member's product review list.\
> \---\
> \## Detailed Description\
> \* Retrieves the list of product reviews written by the member.\
> \* Retrieves the count of product reviews written by the member.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getProductReview":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Product Review List","description":"## Function Description\n* Retrieves the member's product review list.\n---\n## Detailed Description\n* Retrieves the list of product reviews written by the member.\n* Retrieves the count of product reviews written by the member.\n","operationId":"getProductReview","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsReviewRequest"}},{"name":"GoodsReviewRequest","in":"query","description":"Member Product Review Retrieval Request","required":true,"schema":{"type":"string","description":"GoodsReviewRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseGoodsReviewResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"GoodsReviewRequest":{"type":"object","description":"Product Review Request DTO","properties":{"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"mbrNm":{"type":"string","description":"Member Name"},"joinDt":{"type":"string","description":"Membership Registration Date"}}},"RealGridListResponseGoodsReviewResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/GoodsReviewResponse"}}}},"GoodsReviewResponse":{"type":"object","description":"Product Review List Retrieval API Response DTO","properties":{"revNo":{"type":"string","description":"Review No."},"revCont":{"type":"string","description":"Review Content"},"revGbCd":{"type":"string","description":"Review Type Code (PR021) 10: Text, 20: Photo, 30: Video, 40: Photo/Video"},"revGbNm":{"type":"string","description":"Review Type Name"},"ansCont":{"type":"string","description":"Answer Details"},"revContCnt":{"type":"string","description":"Review Content Count"},"reco":{"type":"string","description":"Recommendation Count"},"replyCnt":{"type":"string","description":"Comment Count"},"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"revScrVal":{"type":"string","description":"Review Rating"},"ansCnt":{"type":"integer","format":"int32","description":"Evaluation Item Answer Count"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Product Q\&A List

> \## Function Description\
> \* Retrieves the member's product Q\&A list.\
> \---\
> \## Detailed Description\
> \* Retrieves the list of product Q\&As submitted by the member.\
> \* Retrieves the count of product Q\&As submitted by the member.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getProductQa":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Product Q&A List","description":"## Function Description\n* Retrieves the member's product Q&A list.\n---\n## Detailed Description\n* Retrieves the list of product Q&As submitted by the member.\n* Retrieves the count of product Q&As submitted by the member.\n","operationId":"getProductQa","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsQaRequest"}},{"name":"GoodsQaRequest","in":"query","description":"Product Q&A List Retrieval Request","required":true,"schema":{"type":"string","description":"GoodsQaRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseGoodsQaResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"GoodsQaRequest":{"type":"object","description":"Product Q&A Request DTO","properties":{"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"mbrNm":{"type":"string","description":"Member Name"},"joinDt":{"type":"string","description":"Membership Registration Date"}}},"RealGridListResponseGoodsQaResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/GoodsQaResponse"}}}},"GoodsQaResponse":{"type":"object","description":"Product Q&A Question Information Retrieval API Response DTO","properties":{"questNo":{"type":"string","description":"Question No."},"questTypCdNm":{"type":"string","description":"Question Type Code Name"},"procStatCdNm":{"type":"string","description":"Processing Status Code Name"},"questCont":{"type":"string","description":"Question Details"},"mdId":{"type":"string","description":"MD in Charge"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Participated Event List

> \## Function Description\
> \* Retrieves the list of events the member has participated in.\
> \---\
> \## Detailed Description\
> \* Retrieves the list of events the member has participated in.\
> \* Retrieves the count of events the member has participated in.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getParticipationEvent":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Participated Event List","description":"## Function Description\n* Retrieves the list of events the member has participated in.\n---\n## Detailed Description\n* Retrieves the list of events the member has participated in.\n* Retrieves the count of events the member has participated in.\n","operationId":"getParticipationEvent","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/ParticipationEventRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseParticipationEventResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ParticipationEventRequest":{"type":"object","properties":{"mbrNo":{"type":"string"},"loginId":{"type":"string"},"mbrNm":{"type":"string"},"joinDt":{"type":"string"}}},"RealGridListResponseParticipationEventResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/ParticipationEventResponse"}}}},"ParticipationEventResponse":{"type":"object","properties":{"evtNo":{"type":"string"},"evtNm":{"type":"string"},"aplyDt":{"type":"string"},"strDt":{"type":"string"},"endDt":{"type":"string"},"evtPrgsStatCd":{"type":"string"},"evtPrgsStatNm":{"type":"string"},"winDt":{"type":"string"},"winYn":{"type":"string"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Domestic/Foreign Status

> \## Function Description\
> \* Retrieves domestic/foreign status.\
> \---\
> \## Detailed Description\
> \* Retrieves the member's domestic/foreign status.\
> \---\
> \## Notes\
> \* This API only uses the mbrNo field of the Request DTO.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getNafrGbNmYn":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Domestic/Foreign Status","description":"## Function Description\n* Retrieves domestic/foreign status.\n---\n## Detailed Description\n* Retrieves the member's domestic/foreign status.\n---\n## Notes\n* This API only uses the mbrNo field of the Request DTO.\n","operationId":"getNafrGbNmYn","parameters":[{"name":"request","in":"query","description":"Retrieve Domestic/Foreign Status","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Mileage List

> \## Function Description\
> \* Retrieves the member's mileage list.\
> \---\
> \## Detailed Description\
> \* Retrieves the member's mileage list.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMilgHistory":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Mileage List","description":"## Function Description\n* Retrieves the member's mileage list.\n---\n## Detailed Description\n* Retrieves the member's mileage list.\n","operationId":"getMilgHistory","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MemberMilgRequest"}},{"in":"query","required":true}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MemberMilgResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberMilgRequest":{"type":"object","description":"Retrieve Mileage List Request","properties":{"mbrNo":{"type":"string","description":"Member No."},"frDt":{"type":"string","description":"Search Period - Start"},"toDt":{"type":"string","description":"Search Period - End"},"mlgExtcSchdDt":{"type":"string","description":"Scheduled Expiration Date"},"type":{"type":"string","description":"Search Type"},"langCd":{"type":"string","description":"Language Code (CM009)"}}},"MemberMilgResponse":{"type":"object","description":"Retrieve Mileage List Response","properties":{"astRsrvUseGbNm":{"type":"string","description":"Type"},"astRsrvUseCausNm":{"type":"string","description":"Reason"},"ocurDtm":{"type":"string","format":"date-time","description":"Processing Date/Time"},"ocurAmt":{"type":"number","description":"Accrued/Used Amount"},"balAmt":{"type":"number","description":"Balance"},"astMgrNo":{"type":"string","description":"Related No."},"valiEndDt":{"type":"string","description":"Usage End Date/Time"},"astMgrMemo":{"type":"string","description":"Memo"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Refund Account Information

> \## Function Description\
> \* Retrieves the member's refund account information.\
> \---\
> \## Detailed Description\
> \* Retrieves the member's refund account information.\
> \* If valid authorization is not present, the account information is masked.\
> \* For a non-member, retrieves the refund account information corresponding to the order number.\
> \* Masking list\
> &#x20;  \* Member Name\
> &#x20;  \* Refund Account No.\
> &#x20;  \* Refund Account Holder Name<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberRefundActnInfo":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Refund Account Information","description":"## Function Description\n* Retrieves the member's refund account information.\n---\n## Detailed Description\n* Retrieves the member's refund account information.\n* If valid authorization is not present, the account information is masked.\n* For a non-member, retrieves the refund account information corresponding to the order number.\n* Masking list\n   * Member Name\n   * Refund Account No.\n   * Refund Account Holder Name\n","operationId":"getMemberRefundActnInfo","parameters":[{"name":"mbrDetailRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MemberDetailRequest"}},{"name":"MemberDetailRequest","in":"query","description":"Refund Account Retrieval Request","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MemberRefundAccountPopupResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberDetailRequest":{"type":"object","description":"Member Detail Request","properties":{"mbrNo":{"type":"string","description":"Member No."},"mbrNoList":{"type":"array","description":"Member No. List","items":{"type":"string"}},"mbrNm":{"type":"string","description":"Member Name"},"loginId":{"type":"string","description":"Member Login ID"},"svcAgrTypCd":{"type":"string","description":"Service Consent Type Code (ME025)"},"lgcMbrNo":{"type":"string","description":"Core System Member No."},"authCheck":{"type":"boolean","description":"Conditional Masking Status"},"authYn":{"type":"string","description":"Masking Status"},"authTotalYn":{"type":"string","description":"Full Masking Status of Masked Data"},"mbrDlvpSeq":{"type":"string","description":"Member Delivery Address Sequence No."},"ordNo":{"type":"string","description":"Order No."}}},"MemberRefundAccountPopupResponse":{"type":"object","description":"Refund Account Information Response","properties":{"mbrNo":{"type":"string","description":"Member No."},"mbrNm":{"type":"string","description":"Member Name"},"rfdActnNo":{"type":"string","description":"Refund Account No."},"rfdActnDepositorNm":{"type":"string","description":"Refund Account Holder"},"rfdActnCertiYn":{"type":"string","description":"Refund Account Verification Status"},"rfdBankCd":{"type":"string","description":"Refund Account Bank Code"},"loginId":{"type":"string","description":"Member ID"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Member Customs Clearance No. - List

> \## Function Description\
> \* Retrieves the member's customs clearance number history.\
> \---\
> \## Detailed Description\
> \* Retrieves the customs clearance number search list for the target member.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberPcccInfoListByMemberNoData":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Member Customs Clearance No. - List","description":"## Function Description\n* Retrieves the member's customs clearance number history.\n---\n## Detailed Description\n* Retrieves the customs clearance number search list for the target member.\n","operationId":"getMemberPcccInfoListByMemberNoData","parameters":[{"name":"mbrDetailRequest","in":"query","description":"Member Customs Clearance No. Retrieval Request","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MemberCustomsInquiryResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberCustomsInquiryResponse":{"type":"object","description":"Member Customs Clearance No. Retrieval Response","properties":{"mbrNo":{"type":"string","description":"Member No."},"rcvmnNm":{"type":"string","description":"Recipient Name"},"cellPhone":{"type":"string","description":"Mobile Phone Number"},"zipNo":{"type":"string","description":"Postal Code"},"persCstmCd":{"type":"string","description":"Personal Customs Clearance Number"},"sysRegId":{"type":"string","description":"Registrant ID"},"sysRegDtm":{"type":"string","description":"Registration Date/Time"},"sysModId":{"type":"string","description":"Modifier ID"},"sysModDtm":{"type":"string","description":"Modification Date/Time"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Member List Retrieval

> \## Function Description\
> \* Retrieves the member list.\
> \---\
> \## Detailed Description\
> \* Retrieves the list of members matching the given conditions data.\
> \* Search conditions\
> &#x20;  \* Period search\
> &#x20;     \* Searches by setting a start date and end date based on the member registration date.\
> &#x20;     \* The search period cannot exceed 30 days.\
> &#x20;  \* Full period search\
> &#x20;     \* When searching the full period, enter member information (member name or member number or login ID) or mobile phone number to search.\
> \---\
> \## Revision History\
> \* \`\`\`Release v1.07\_231228\`\`\`: Removed the member status code from the Request (search conditions) due to removal of the dormant member logic\
> \* \`\`\`Release v2.00\_240613\`\`\`: Improved period search condition\
> \* \`\`\`Release v2.00\_240627\`\`\`: Modified due to addition of (ME025) Kakao Talk service type\
> \* \`\`\`Release v2.00\_250711\`\`\`: Added business member search condition (for business members, only approved members are searched)<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberList":{"get":{"tags":["Member Information Management"],"summary":"Member List Retrieval","description":"## Function Description\n* Retrieves the member list.\n---\n## Detailed Description\n* Retrieves the list of members matching the given conditions data.\n* Search conditions\n   * Period search\n      * Searches by setting a start date and end date based on the member registration date.\n      * The search period cannot exceed 30 days.\n   * Full period search\n      * When searching the full period, enter member information (member name or member number or login ID) or mobile phone number to search.\n---\n## Revision History\n* ```Release v1.07_231228```: Removed the member status code from the Request (search conditions) due to removal of the dormant member logic\n* ```Release v2.00_240613```: Improved period search condition\n* ```Release v2.00_240627```: Modified due to addition of (ME025) Kakao Talk service type\n* ```Release v2.00_250711```: Added business member search condition (for business members, only approved members are searched)\n","operationId":"getMemberList","parameters":[{"name":"mbrMgmtSearchRequest","in":"query","description":"Member List Retrieval","required":true,"schema":{"type":"MemberMgmtSearchRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseMemberMgmtSearchResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"RealGridListResponseMemberMgmtSearchResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/MemberMgmtSearchResponse"}}}},"MemberMgmtSearchResponse":{"type":"object","description":"Member List Retrieval Response","properties":{"mbrNo":{"type":"string","description":"Member No."},"socialNm":{"type":"string","description":"Simple Account Linking Type Code Name (ME052)"},"mbrNm":{"type":"string","description":"Member Name"},"mbrStatCd":{"type":"string","description":"Member Status Code (ME003)"},"loginId":{"type":"string","description":"Login ID"},"emailAddr":{"type":"string","description":"Email Address"},"cellNo":{"type":"string","description":"Mobile Phone Number"},"zipAddr":{"type":"string","description":"Postal Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"mbrJoinDtm":{"type":"string","description":"Membership Registration Date/Time"},"sysModId":{"type":"string","description":"System Modifier ID"},"sysModDtm":{"type":"string","format":"date-time","description":"System Modification Date/Time"},"joinGbCd":{"type":"string","description":"Registration Type Code (ME029)"},"mbrMgrCd":{"type":"string","description":"Member Management Code (ME002)"},"mbrMgrNm":{"type":"string","description":"Member Management Code Name (ME002)"},"mbrGradeNm":{"type":"string","description":"Member Grade Code Name (ME008)"},"mbrStatNm":{"type":"string","description":"Member Status Code Name (ME003)"},"stafYn":{"type":"string","description":"Employee Status"},"mbrCareConsumeYn":{"type":"string","description":"Interested Customer Status"},"siteNm":{"type":"string","description":"Site Name"},"smsRecvAgrYn":{"type":"string","description":"SMS Reception Consent Status"},"emailRecvAgrYn":{"type":"string","description":"Email Reception Consent Status"},"appPushAgrYn":{"type":"string","description":"App Push Consent Status"},"kakaoRecvAgrYn":{"type":"string","description":"KakaoTalk Reception Consent Status"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
````

## Retrieve Member Additional Information

> \## Function Description\
> \* Retrieves the member's additional information.\
> \---\
> \## Detailed Description\
> \* Retrieves the member's additional information.\
> \---\
> \## Revision History\
> \* \`\`\`Release v2.00\_240530\`\`\`: Added social login (Google, Apple)<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberJoinInfo":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Member Additional Information","description":"## Function Description\n* Retrieves the member's additional information.\n---\n## Detailed Description\n* Retrieves the member's additional information.\n---\n## Revision History\n* ```Release v2.00_240530```: Added social login (Google, Apple)\n","operationId":"getMemberJoinInfo","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MemberDetailRequest"}},{"name":"MemberDetailRequest","in":"query","description":"Member Additional Information Retrieval Request","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MemberJoinInfoResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberDetailRequest":{"type":"object","description":"Member Detail Request","properties":{"mbrNo":{"type":"string","description":"Member No."},"mbrNoList":{"type":"array","description":"Member No. List","items":{"type":"string"}},"mbrNm":{"type":"string","description":"Member Name"},"loginId":{"type":"string","description":"Member Login ID"},"svcAgrTypCd":{"type":"string","description":"Service Consent Type Code (ME025)"},"lgcMbrNo":{"type":"string","description":"Core System Member No."},"authCheck":{"type":"boolean","description":"Conditional Masking Status"},"authYn":{"type":"string","description":"Masking Status"},"authTotalYn":{"type":"string","description":"Full Masking Status of Masked Data"},"mbrDlvpSeq":{"type":"string","description":"Member Delivery Address Sequence No."},"ordNo":{"type":"string","description":"Order No."}}},"MemberJoinInfoResponse":{"type":"object","description":"Member Additional Information Response","properties":{"mbrJoinDtm":{"type":"string","format":"date-time","description":"Membership Registration Date/Time"},"lstLoginDtm":{"type":"string","format":"date-time","description":"Last Login Date/Time"},"lstOrdDtm":{"type":"string","format":"date-time","description":"Last Order Date/Time"},"snsLinkYn":{"type":"string","description":"SNS Integration Status"},"snsLinkStrDtm":{"type":"string","format":"date-time","description":"SNS Integration Date and Time"},"siteNo":{"type":"string","description":"Registered Site No."},"siteNm":{"type":"string","description":"Registration Site Name"},"pwdChgDtm":{"type":"string","description":"Password Change Date/Time"},"stpRvcDt":{"type":"string","description":"Dormant Status Release Date"},"lgcMbrNo":{"type":"string","description":"Core System Member No."},"mbrNo":{"type":"string","description":"Member No."},"snsLinkInfoList":{"type":"array","description":"SNS Integrated Account List","items":{"$ref":"#/components/schemas/EtLoginSnsLinkInfo"}}}},"EtLoginSnsLinkInfo":{"type":"object","description":"Login SNS Integration Information","properties":{"mbrNo":{"type":"string","description":"Member No."},"smpctAcctLinkGbCd":{"type":"string","description":"Simple Account Linking Classification Code (ME052)"},"smpctAcctLinkGbCdNm":{"type":"string","description":"Simple Account Linking Type Code Name (ME052)"},"snsLinkYn":{"type":"string","description":"SNS Integration Status"},"snsLinkStrDtm":{"type":"string","format":"date-time","description":"SNS Integration Start Date and Time"},"snsLinkEndDtm":{"type":"string","format":"date-time","description":"SNS Integration End Date and Time"},"snsLinkId":{"type":"string","description":"SNS Integration ID"},"snsMbrNo":{"type":"string","description":"SNS Member No."},"rmkConts":{"type":"string","description":"Remarks"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
````

## Retrieve Member Details

> \## Function Description\
> \* Retrieves the member's detail information.\
> \---\
> \## Detailed Description\
> \* Retrieves the member's personal information and detail content.\
> \* Personal information masking conditions\
> &#x20;  \* When the administrator does not have personal information viewing authorization\
> &#x20;  \* When the administrator has personal information viewing authorization but does not have authorization for the corresponding item<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberInfo":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Member Details","description":"## Function Description\n* Retrieves the member's detail information.\n---\n## Detailed Description\n* Retrieves the member's personal information and detail content.\n* Personal information masking conditions\n   * When the administrator does not have personal information viewing authorization\n   * When the administrator has personal information viewing authorization but does not have authorization for the corresponding item\n","operationId":"getMemberInfo","parameters":[{"name":"mbrDetailRequest","in":"query","description":"Retrieve Member Details","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MemberDetailResponseVO"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberDetailResponseVO":{"type":"object","properties":{"memberInfo":{"$ref":"#/components/schemas/MemberDetailResponse"},"realGridList":{"$ref":"#/components/schemas/RealGridListResponseMemberDlvpResponse"}}},"MemberDetailResponse":{"type":"object","description":"Member Detail Response","properties":{"mbrNo":{"type":"string","description":"Member No."},"mbrNm":{"type":"string","description":"Member Name"},"loginId":{"type":"string","description":"Login ID"},"id":{"type":"string","description":"Login ID noMasking"},"mbrMgrCd":{"type":"string","description":"Member Management Code (ME002)"},"mbrGbNm":{"type":"string","description":"Member Type Code Name (ME001)"},"mbrMgrNm":{"type":"string","description":"Member Management Code Name (ME002)"},"stafMgrNo":{"type":"string","description":"Employee Management No."},"instMbrYn":{"type":"string","description":"Interested Customer Status"},"instMbrGb":{"type":"string","description":"Interested Customer Type"},"ordLmtYn":{"type":"string","description":"Purchase Restriction Status"},"stafYn":{"type":"string","description":"Employee Status"},"mbrStatCd":{"type":"string","description":"Member Status Code (ME003)"},"mbrStatNm":{"type":"string","description":"Member Status Code Name (ME003)"},"mbrGradeNm":{"type":"string","description":"Member Grade Code Name (ME008)"},"solarYn":{"type":"string","description":"Solar Calendar Status"},"brth":{"type":"string","description":"Date of Birth"},"sexGbNm":{"type":"string","description":"Gender Type Code Name (ME017)"},"nafrGbNm":{"type":"string","description":"Domestic/Foreign Status"},"telNo":{"type":"string","description":"Phone Number"},"telRgnNo":{"type":"string","description":"Phone Area Code"},"telTxnoNo":{"type":"string","description":"Phone Exchange Code"},"telEndNo":{"type":"string","description":"Phone Last Digits"},"cellNo":{"type":"string","description":"Mobile Phone Number"},"cellSctNo":{"type":"string","description":"Mobile Phone Prefix Code"},"cellTxnoNo":{"type":"string","description":"Mobile Phone Exchange Code"},"cellEndNo":{"type":"string","description":"Mobile Phone Last Digits"},"emailAddr":{"type":"string","description":"Email Address"},"zipNoSeq":{"type":"integer","format":"int64","description":"Postal Code Sequence No."},"zipNo":{"type":"string","description":"Postal Code"},"dtlAddr":{"type":"string","description":"Detailed Address"},"zipAddr":{"type":"string","description":"Postal Address"},"siteNo":{"type":"string","description":"Registered Site No."},"joinGbNm":{"type":"string","description":"Registration Type Code Name (ME029)"},"adlCertiYn":{"type":"string","description":"Adult Verification Status"},"adlCertiDtm":{"type":"string","format":"date-time","description":"Adult Verification Date/Time"},"mbrJoinDtm":{"type":"string","format":"date-time","description":"Membership Registration Date/Time"},"frstOrdDtm":{"type":"string","format":"date-time","description":"First Order Date/Time"},"lstOrdDtm":{"type":"string","format":"date-time","description":"Last Order Date/Time"},"frstLoginDtm":{"type":"string","format":"date-time","description":"First Login Date/Time"},"lstLoginDtm":{"type":"string","format":"date-time","description":"Last Login Date/Time"},"mbrCertiGbNm":{"type":"string","description":"Member Authentication Type Code Name (ME005)"},"pwdQuestCont":{"type":"string","description":"Password Question Content"},"pwdAnsCont":{"type":"string","description":"Password Answer Content"},"pwdFailCnt":{"type":"integer","format":"int64","description":"Password Failure Count"},"pwdIniYn":{"type":"string","description":"Password Reset Status"},"pwdChgDtm":{"type":"string","format":"date-time","description":"Password Change Date/Time"},"pwdIniCausCont":{"type":"string","description":"Password Reset Reason Content"},"ciCtacVal":{"type":"string","description":"CI Linkage Value"},"stpProcDt":{"type":"string","description":"Dormant Processing Date"},"stpRvcDt":{"type":"string","description":"Dormant Status Release Date"},"mbrWdraDtm":{"type":"string","format":"date-time","description":"Member Withdrawal Date and Time"},"mbrWdraCausCont":{"type":"string","description":"Member Withdrawal Reason Content"},"comGbNm":{"type":"string","description":"Employee - Company Type Code Name (ME038)"},"smpctAcctLinkGbCd":{"type":"string","description":"Simple Account Linking Classification Code (ME052)"},"smpctAcctLinkGbNm":{"type":"string","description":"Simple Account Integration Type Code Name"},"bmanRegNo":{"type":"string","description":"Business Registration No."},"bmanRegDt":{"type":"string","description":"Business Registration Date and Time"},"rpstmnNm":{"type":"string","description":"Representative Name"},"repTelSctNo":{"type":"string","description":"Main Phone No."},"repTelTxnoNo":{"type":"string","description":"Main Phone Exchange Code"},"repTelEndNo":{"type":"string","description":"Main Phone Last Digits"},"repTelNo":{"type":"string","description":"Representative Phone Number"},"bmanNm":{"type":"string","description":"Business Name"},"bplcZipNo":{"type":"string","description":"Business Postal Code"},"bplcZipAddr":{"type":"string","description":"Business Address"},"bplcDtlAddr":{"type":"string","description":"Business Detailed Address"},"atchFilePathNm":{"type":"string","description":"Business Attachment File Path"},"aempNm":{"type":"string","description":"Person in Charge Name"},"aempCellSctNo":{"type":"string","description":"Contact Person Mobile Phone Area Code"},"aempCellTxnoNo":{"type":"string","description":"Contact Person Mobile Phone Exchange No."},"aempCellEndNo":{"type":"string","description":"Contact Person Mobile Phone Last Digits"}}},"RealGridListResponseMemberDlvpResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/MemberDlvpResponse"}}}},"MemberDlvpResponse":{"type":"object","description":"Member Delivery Address Retrieval Response","properties":{"mbrNo":{"type":"string","description":"Member No."},"mbrDlvpSeq":{"type":"string","description":"Member Delivery Address Sequence No."},"dlvpNm":{"type":"string","description":"Delivery Address Name"},"rcvmnNm":{"type":"string","description":"Recipient Name"},"baseDlvpYn":{"type":"string","description":"Default Delivery Address Status"},"nafrGbNmYn":{"type":"string","description":"Domestic/Foreign Status"},"zipNoSeq":{"type":"integer","format":"int64","description":"Postal Code Sequence No."},"zipNo":{"type":"string","description":"Postal Code"},"zipAddr":{"type":"string","description":"Postal Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"emailAddr":{"type":"string","description":"Email Address"},"telNo":{"type":"string","description":"Phone Number"},"telRgnNo":{"type":"string","description":"Phone Area Code"},"telTxnoNo":{"type":"string","description":"Phone Exchange Code"},"telEndNo":{"type":"string","description":"Phone Last Digits"},"cellNo":{"type":"string","description":"Mobile Phone Number"},"cellSctNo":{"type":"string","description":"Mobile Phone Prefix Code"},"cellTxnoNo":{"type":"string","description":"Mobile Phone Exchange Code"},"cellEndNo":{"type":"string","description":"Mobile Phone Last Digits"},"deliMsgCd":{"type":"string","description":"Delivery Message Code (ME039)"},"deliMsgNm":{"type":"string","description":"Delivery Message Code Name (ME039)"},"deliMsg":{"type":"string","description":"Delivery Message"},"comnFrdrCogoMethodCd":{"type":"string","description":"Common Entrance Access Method Code (ME040)"},"comnFrdrCogoMethodNm":{"type":"string","description":"Common Entrance Access Method Code Name (ME040)"},"comnFrdrEtcMethod":{"type":"string","description":"Other Common Entrance Access Method"},"comnFrdrPwd":{"type":"string","description":"Common Entrance Password"},"useYn":{"type":"string","description":"Usage Status"},"sysRegId":{"type":"string","description":"System Registrant ID"},"sysRedDtm":{"type":"string","description":"System Registration Date/Time"},"sysModId":{"type":"string","description":"System Modifier ID"},"sysModDtm":{"type":"string","description":"System Modification Date/Time"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Member History List

> \## Function Description\
> \* Dynamically retrieves the member's various history lists.\
> \---\
> \## Detailed Description\
> \* The member's personal information change history can be dynamically retrieved according to history type.\
> \* Supports various history types such as address (11), mobile phone number (12), phone number (13), email (14), etc.\
> \* Multiple history types can be retrieved at once via the history type list.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberHistoryList":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Member History List","description":"## Function Description\n* Dynamically retrieves the member's various history lists.\n---\n## Detailed Description\n* The member's personal information change history can be dynamically retrieved according to history type.\n* Supports various history types such as address (11), mobile phone number (12), phone number (13), email (14), etc.\n* Multiple history types can be retrieved at once via the history type list.\n","operationId":"getMemberHistoryList","parameters":[{"name":"memberHistoryRequest","in":"query","description":"Retrieve Member History Request","required":true,"schema":{"type":"string","description":"MemberHistoryRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseMemberHistoryResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"RealGridListResponseMemberHistoryResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/MemberHistoryResponse"}}}},"MemberHistoryResponse":{"type":"object","description":"Member History Retrieval Response","properties":{"mbrNo":{"type":"string","description":"Member No."},"mbrNm":{"type":"string","description":"Member Name"},"chgTgtTypCd":{"type":"string","description":"Change Target Type Code (ME004)"},"chgTgtTypNm":{"type":"string","description":"Change Target Type Code Name (ME004)"},"chgCont":{"type":"string","description":"Change Content"},"sysRegId":{"type":"string","description":"Registrant"},"sysRegDtm":{"type":"string","description":"Registration Date/Time"},"mbrInfoChgSeq":{"type":"string","description":"Member Information Change Sequence No."}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Member Grade History - List

> \## Function Description\
> \* Retrieves the member grade history.\
> \---\
> \## Detailed Description\
> \* Retrieves the member grade change history list for the target member.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberGradeHistoryByMemberNoData":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Member Grade History - List","description":"## Function Description\n* Retrieves the member grade history.\n---\n## Detailed Description\n* Retrieves the member grade change history list for the target member.\n","operationId":"getMemberGradeHistoryByMemberNoData","parameters":[{"name":"mbrDetailRequest","in":"query","description":"Retrieve Member Grade History Request","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MemberGradeHistoryResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberGradeHistoryResponse":{"type":"object","description":"Member Grade History Retrieval Response","properties":{"mbrNo":{"type":"string","description":"Member No."},"mbrGradeCd":{"type":"string","description":"Member Grade Code (ME008)"},"mbrGradeNm":{"type":"string","description":"Member Grade Name (ME008)"},"histStrDtm":{"type":"string","description":"History Start Date/Time"},"histEndDtm":{"type":"string","description":"History End Date/Time"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Member Grade History Count

> \## Function Description\
> \* Retrieves the total count of the member grade history list.\
> \---\
> \## Detailed Description\
> \* Retrieves the total count of member grade change history for the target member.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberGradeHistoryByMemberNoCount":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Member Grade History Count","description":"## Function Description\n* Retrieves the total count of the member grade history list.\n---\n## Detailed Description\n* Retrieves the total count of member grade change history for the target member.\n","operationId":"getCustomerGradeHistoryByMemberNoCount","parameters":[{"name":"mbrDetailRequest","in":"query","description":"Retrieve Member Grade History Request","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Delivery Address (Unmasked)

> \## Function Description\
> \* Retrieves the delivery address list.\
> \---\
> \## Detailed Description\
> \* Retrieves the list of delivery addresses registered by the member.\
> \* The member's personal information is displayed regardless of the administrator's personal information viewing authorization.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberDeliveryNoMasking":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Delivery Address (Unmasked)","description":"## Function Description\n* Retrieves the delivery address list.\n---\n## Detailed Description\n* Retrieves the list of delivery addresses registered by the member.\n* The member's personal information is displayed regardless of the administrator's personal information viewing authorization.\n","operationId":"getMemberDeliveryNoMasking","parameters":[{"name":"memberDetailRequest","in":"query","description":"Delivery Address List Retrieval Request","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MemberDlvpNoMaskingResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberDlvpNoMaskingResponse":{"type":"object","description":"Member Delivery Address Personal Information Unmasked Retrieval Response","properties":{"mbrNo":{"type":"string","description":"Member No."},"mbrDlvpSeq":{"type":"string","description":"Member Delivery Address Sequence No."},"dlvpNm":{"type":"string","description":"Delivery Address Name"},"rcvmnNm":{"type":"string","description":"Recipient Name"},"baseDlvpYn":{"type":"string","description":"Default Delivery Address Status"},"nafrGbNmYn":{"type":"string","description":"Domestic/Foreign Status"},"zipNoSeq":{"type":"integer","format":"int64","description":"Postal Code Sequence No."},"zipNo":{"type":"string","description":"Postal Code"},"zipAddr":{"type":"string","description":"Postal Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"emailAddr":{"type":"string","description":"Email Address"},"telNo":{"type":"string","description":"Phone Number"},"telRgnNo":{"type":"string","description":"Phone Area Code"},"telTxnoNo":{"type":"string","description":"Phone Exchange Code"},"telEndNo":{"type":"string","description":"Phone Last Digits"},"cellNo":{"type":"string","description":"Mobile Phone Number"},"cellSctNo":{"type":"string","description":"Mobile Phone Prefix Code"},"cellTxnoNo":{"type":"string","description":"Mobile Phone Exchange Code"},"cellEndNo":{"type":"string","description":"Mobile Phone Last Digits"},"deliMsgCd":{"type":"string","description":"Delivery Message Code (ME039)"},"deliMsgNm":{"type":"string","description":"Delivery Message Code Name (ME039)"},"deliMsg":{"type":"string","description":"Delivery Message"},"comnFrdrCogoMethodCd":{"type":"string","description":"Common Entrance Access Method Code (ME040)"},"comnFrdrCogoMethodNm":{"type":"string","description":"Common Entrance Access Method Code Name (ME040)"},"comnFrdrEtcMethod":{"type":"string","description":"Other Common Entrance Access Method"},"comnFrdrPwd":{"type":"string","description":"Common Entrance Password"},"useYn":{"type":"string","description":"Usage Status"},"sysRegId":{"type":"string","description":"System Registrant ID"},"sysRedDtm":{"type":"string","description":"System Registration Date/Time"},"sysModId":{"type":"string","description":"System Modifier ID"},"sysModDtm":{"type":"string","description":"System Modification Date/Time"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Delivery Address (Masked)

> \## Function Description\
> \* Retrieves the delivery address list.\
> \---\
> \## Detailed Description\
> \* Retrieves the list of delivery addresses registered by the member.\
> \* All of the member's personal information is displayed masked regardless of the administrator's personal information viewing authorization.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberDeliveryMaskingList":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Delivery Address (Masked)","description":"## Function Description\n* Retrieves the delivery address list.\n---\n## Detailed Description\n* Retrieves the list of delivery addresses registered by the member.\n* All of the member's personal information is displayed masked regardless of the administrator's personal information viewing authorization.\n","operationId":"getMemberDeliveryMaskingList","parameters":[{"name":"mbrDetailRequest","in":"query","description":"Delivery Address List Retrieval Request","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseMemberDlvpMaskingResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"RealGridListResponseMemberDlvpMaskingResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/MemberDlvpMaskingResponse"}}}},"MemberDlvpMaskingResponse":{"type":"object","description":"Member Delivery Address Personal Information Masked Retrieval Response","properties":{"mbrNo":{"type":"string","description":"Member No."},"mbrDlvpSeq":{"type":"string","description":"Member Delivery Address Sequence No."},"dlvpNm":{"type":"string","description":"Delivery Address Name"},"rcvmnNm":{"type":"string","description":"Recipient Name"},"baseDlvpYn":{"type":"string","description":"Default Delivery Address Status"},"nafrGbNmYn":{"type":"string","description":"Domestic/Foreign Status"},"zipNoSeq":{"type":"integer","format":"int64","description":"Postal Code Sequence No."},"zipNo":{"type":"string","description":"Postal Code"},"zipAddr":{"type":"string","description":"Postal Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"emailAddr":{"type":"string","description":"Email Address"},"telNo":{"type":"string","description":"Phone Number"},"telRgnNo":{"type":"string","description":"Phone Area Code"},"telTxnoNo":{"type":"string","description":"Phone Exchange Code"},"telEndNo":{"type":"string","description":"Phone Last Digits"},"cellNo":{"type":"string","description":"Mobile Phone Number"},"cellSctNo":{"type":"string","description":"Mobile Phone Prefix Code"},"cellTxnoNo":{"type":"string","description":"Mobile Phone Exchange Code"},"cellEndNo":{"type":"string","description":"Mobile Phone Last Digits"},"deliMsgCd":{"type":"string","description":"Delivery Message Code (ME039)"},"deliMsgNm":{"type":"string","description":"Delivery Message Code Name (ME039)"},"deliMsg":{"type":"string","description":"Delivery Message"},"comnFrdrCogoMethodCd":{"type":"string","description":"Common Entrance Access Method Code (ME040)"},"comnFrdrCogoMethodNm":{"type":"string","description":"Common Entrance Access Method Code Name (ME040)"},"comnFrdrEtcMethod":{"type":"string","description":"Other Common Entrance Access Method"},"comnFrdrPwd":{"type":"string","description":"Common Entrance Password"},"useYn":{"type":"string","description":"Usage Status"},"sysRegId":{"type":"string","description":"System Registrant ID"},"sysRedDtm":{"type":"string","description":"System Registration Date/Time"},"sysModId":{"type":"string","description":"System Modifier ID"},"sysModDtm":{"type":"string","description":"System Modification Date/Time"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Member Delivery Address - List

> \## Function Description\
> \* Retrieves the delivery address list.\
> \---\
> \## Detailed Description\
> \* Retrieves the list of delivery addresses registered by the member.\
> \* Personal information is displayed masked according to the administrator's personal information viewing authorization.\
> \* Personal information masking display conditions\
> &#x20;  \* When the administrator does not have personal information viewing authorization\
> &#x20;  \* When the administrator has personal information viewing authorization but does not have authorization for the corresponding item<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberDeliveryList":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Member Delivery Address - List","description":"## Function Description\n* Retrieves the delivery address list.\n---\n## Detailed Description\n* Retrieves the list of delivery addresses registered by the member.\n* Personal information is displayed masked according to the administrator's personal information viewing authorization.\n* Personal information masking display conditions\n   * When the administrator does not have personal information viewing authorization\n   * When the administrator has personal information viewing authorization but does not have authorization for the corresponding item\n","operationId":"getMemberDeliveryList","parameters":[{"name":"mbrDetailRequest","in":"query","description":"Delivery Address List Retrieval Request","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MemberDlvpResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberDlvpResponse":{"type":"object","description":"Member Delivery Address Retrieval Response","properties":{"mbrNo":{"type":"string","description":"Member No."},"mbrDlvpSeq":{"type":"string","description":"Member Delivery Address Sequence No."},"dlvpNm":{"type":"string","description":"Delivery Address Name"},"rcvmnNm":{"type":"string","description":"Recipient Name"},"baseDlvpYn":{"type":"string","description":"Default Delivery Address Status"},"nafrGbNmYn":{"type":"string","description":"Domestic/Foreign Status"},"zipNoSeq":{"type":"integer","format":"int64","description":"Postal Code Sequence No."},"zipNo":{"type":"string","description":"Postal Code"},"zipAddr":{"type":"string","description":"Postal Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"emailAddr":{"type":"string","description":"Email Address"},"telNo":{"type":"string","description":"Phone Number"},"telRgnNo":{"type":"string","description":"Phone Area Code"},"telTxnoNo":{"type":"string","description":"Phone Exchange Code"},"telEndNo":{"type":"string","description":"Phone Last Digits"},"cellNo":{"type":"string","description":"Mobile Phone Number"},"cellSctNo":{"type":"string","description":"Mobile Phone Prefix Code"},"cellTxnoNo":{"type":"string","description":"Mobile Phone Exchange Code"},"cellEndNo":{"type":"string","description":"Mobile Phone Last Digits"},"deliMsgCd":{"type":"string","description":"Delivery Message Code (ME039)"},"deliMsgNm":{"type":"string","description":"Delivery Message Code Name (ME039)"},"deliMsg":{"type":"string","description":"Delivery Message"},"comnFrdrCogoMethodCd":{"type":"string","description":"Common Entrance Access Method Code (ME040)"},"comnFrdrCogoMethodNm":{"type":"string","description":"Common Entrance Access Method Code Name (ME040)"},"comnFrdrEtcMethod":{"type":"string","description":"Other Common Entrance Access Method"},"comnFrdrPwd":{"type":"string","description":"Common Entrance Password"},"useYn":{"type":"string","description":"Usage Status"},"sysRegId":{"type":"string","description":"System Registrant ID"},"sysRedDtm":{"type":"string","description":"System Registration Date/Time"},"sysModId":{"type":"string","description":"System Modifier ID"},"sysModDtm":{"type":"string","description":"System Modification Date/Time"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Member Delivery Address Count

> \## Function Description\
> \* Retrieves the count of the delivery address list.\
> \---\
> \## Detailed Description\
> \* Retrieves the total count of the delivery address list registered by the member.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberDeliveryListCount":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Member Delivery Address Count","description":"## Function Description\n* Retrieves the count of the delivery address list.\n---\n## Detailed Description\n* Retrieves the total count of the delivery address list registered by the member.\n","operationId":"getMemberDeliveryListCount","parameters":[{"name":"mbrDetailRequest","in":"query","description":"Member Delivery Address Total Count Retrieval Request","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Member Contact Information Change History List

> \## Function Description\
> \* Retrieves the member's contact information history list.\
> \---\
> \## Detailed Description\
> \* Retrieves the contact information change history among the member's personal information change history.\
> \* Personal information is displayed masked according to the administrator's personal information viewing authorization.\
> \* Personal information masking display conditions\
> &#x20;  \* When the administrator does not have personal information viewing authorization\
> &#x20;  \* When the administrator has personal information viewing authorization but does not have authorization for the corresponding item<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberContactHistoryByMemberNoData":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Member Contact Information Change History List","description":"## Function Description\n* Retrieves the member's contact information history list.\n---\n## Detailed Description\n* Retrieves the contact information change history among the member's personal information change history.\n* Personal information is displayed masked according to the administrator's personal information viewing authorization.\n* Personal information masking display conditions\n   * When the administrator does not have personal information viewing authorization\n   * When the administrator has personal information viewing authorization but does not have authorization for the corresponding item\n","operationId":"getMemberContactHistoryByMemberNoData","parameters":[{"name":"mbrDetailRequest","in":"query","description":"Member Contact Information Change History List Retrieval Request","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MemberContactHistoryResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberContactHistoryResponse":{"type":"object","description":"Member Contact Information History Retrieval Response","properties":{"chgTgtTypNm":{"type":"string","description":"Change Target Type Code Name (ME004)"},"chgTgtTypCd":{"type":"string","description":"Change Target Type Code (ME004)"},"chgCellNo":{"type":"string","description":"Mobile Phone No. Change Content"},"chgTelNo":{"type":"string","description":"Phone Number Change Content"},"chgEmail":{"type":"string","description":"Email Change Content"},"sysRegId":{"type":"string","description":"Registrant > Modifier"},"sysRegDtm":{"type":"string","description":"Registration Date/Time > Modification Date/Time"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Member Contact Information Change History Count

> \## Function Description\
> \* Retrieves the total count of the member's contact information change history.\
> \---\
> \## Detailed Description\
> \* Retrieves the total count of contact information change history among the member's personal information change history.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberContactHistoryByMemberNoCount":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Member Contact Information Change History Count","description":"## Function Description\n* Retrieves the total count of the member's contact information change history.\n---\n## Detailed Description\n* Retrieves the total count of contact information change history among the member's personal information change history.\n","operationId":"getCustomerContactHistoryByMemberNoCount","parameters":[{"name":"mbrDetailRequest","in":"query","description":"Member Contact Information Change History Count Retrieval Request","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Business Contact Person Information Change History List

> \## Function Description\
> \* Retrieves the business contact person information change history list.\
> \---\
> \## Detailed Description\
> \* Retrieves the business contact person information change history list.\
> \* Personal information is displayed masked according to the administrator's personal information viewing authorization.\
> \* Personal information masking display conditions\
> &#x20;  \* When the administrator does not have personal information viewing authorization\
> &#x20;  \* When the administrator has personal information viewing authorization but does not have authorization for the corresponding item<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberAempHistory":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Business Contact Person Information Change History List","description":"## Function Description\n* Retrieves the business contact person information change history list.\n---\n## Detailed Description\n* Retrieves the business contact person information change history list.\n* Personal information is displayed masked according to the administrator's personal information viewing authorization.\n* Personal information masking display conditions\n   * When the administrator does not have personal information viewing authorization\n   * When the administrator has personal information viewing authorization but does not have authorization for the corresponding item\n","operationId":"getMemberAempHistory","parameters":[{"name":"memberHistoryRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MemberHistoryRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseMemberAempHistoryResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberHistoryRequest":{"type":"object","description":"Retrieve Member History Request","properties":{"indInfoQryCaus":{"type":"string","description":"Personal Information Retrieval Reason"},"mbrNo":{"type":"string","description":"Member No."},"historyTypes":{"type":"array","description":"History Type Code List (ME004)","items":{"type":"string"}},"authYn":{"type":"string","description":"Masking Status"},"authTotalYn":{"type":"string","description":"Full Masking Status"}}},"RealGridListResponseMemberAempHistoryResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/MemberAempHistoryResponse"}}}},"MemberAempHistoryResponse":{"type":"object","description":"Business Contact Person Information Change History Retrieval Response","properties":{"aempNm":{"type":"string","description":"Person in Charge Name"},"aempCellNo":{"type":"string","description":"Contact Person Mobile Phone No."},"sysRegId":{"type":"string","description":"Registrant"},"sysRegDtm":{"type":"string","description":"Registration Date/Time"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Address Change History List

> \## Function Description\
> \* Retrieves the address change history list.\
> \---\
> \## Detailed Description\
> \* Retrieves the address change history list among the member's personal information change history.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberAddressHistoryByMemberNoData":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Address Change History List","description":"## Function Description\n* Retrieves the address change history list.\n---\n## Detailed Description\n* Retrieves the address change history list among the member's personal information change history.\n","operationId":"getMemberAddressHistoryByMemberNoData","parameters":[{"name":"mbrDetailRequest","in":"query","description":"Address Change History List Retrieval Request","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MemberAddressHistoryResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberAddressHistoryResponse":{"type":"object","description":"Address Change History Retrieval Response","properties":{"chgTgtTypNm":{"type":"string","description":"Change Target Type Code Name (ME004)"},"chgCont":{"type":"string","description":"Change Content"},"sysRegId":{"type":"string","description":"Registrant > Modifier"},"sysRegDtm":{"type":"string","description":"Registration Date/Time > Modification Date/Time"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Address Change History Count

> \## Function Description\
> \* Retrieves the total count of the address change history.\
> \---\
> \## Detailed Description\
> \* Retrieves the total count of the address change history list among the member's personal information change history.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMemberAddressHistoryByMemberNoCount":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Address Change History Count","description":"## Function Description\n* Retrieves the total count of the address change history.\n---\n## Detailed Description\n* Retrieves the total count of the address change history list among the member's personal information change history.\n","operationId":"getCustomerAddressHistoryByMemberNoCount","parameters":[{"name":"mbrDetailRequest","in":"query","description":"Address Change History Retrieval Request","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Mileage

> \## Function Description\
> \* Retrieves the member's mileage.\
> \---\
> \## Detailed Description\
> \* Retrieves the member's available mileage.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMbrMilg":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Mileage","description":"## Function Description\n* Retrieves the member's mileage.\n---\n## Detailed Description\n* Retrieves the member's available mileage.\n","operationId":"getMbrMilg","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MemberDetailRequest"}},{"name":"MemberDetailRequest","in":"query","description":"Retrieve Mileage Request","required":true,"schema":{"type":"string","description":"MemberDetailRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int64"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MemberDetailRequest":{"type":"object","description":"Member Detail Request","properties":{"mbrNo":{"type":"string","description":"Member No."},"mbrNoList":{"type":"array","description":"Member No. List","items":{"type":"string"}},"mbrNm":{"type":"string","description":"Member Name"},"loginId":{"type":"string","description":"Member Login ID"},"svcAgrTypCd":{"type":"string","description":"Service Consent Type Code (ME025)"},"lgcMbrNo":{"type":"string","description":"Core System Member No."},"authCheck":{"type":"boolean","description":"Conditional Masking Status"},"authYn":{"type":"string","description":"Masking Status"},"authTotalYn":{"type":"string","description":"Full Masking Status of Masked Data"},"mbrDlvpSeq":{"type":"string","description":"Member Delivery Address Sequence No."},"ordNo":{"type":"string","description":"Order No."}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Coupon Count

> \## Function Description\
> \* Retrieves the member's coupon count.\
> \---\
> \## Detailed Description\
> \* Retrieves the count of valid coupons currently usable by the member.\
> \* The free shipping coupon count, general coupon count, and compensation coupon count are retrieved.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getMbrCpnCntList":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Coupon Count","description":"## Function Description\n* Retrieves the member's coupon count.\n---\n## Detailed Description\n* Retrieves the count of valid coupons currently usable by the member.\n* The free shipping coupon count, general coupon count, and compensation coupon count are retrieved.\n","operationId":"getMbrCpnCntList","parameters":[{"name":"mbrNo","in":"query","description":"Member No.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MbrCouponResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"MbrCouponResponse":{"type":"object","description":"Coupon Count Retrieval Response","properties":{"freeCnt":{"type":"string","description":"Free Shipping Coupon Count"},"gnrCnt":{"type":"string","description":"General Coupon Count"},"cpstCnt":{"type":"string","description":"Compensation Coupon Count"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```

## Retrieve Customer Center 1:1 Inquiry List

> \## Function Description\
> \* Retrieves the member's Customer Center 1:1 Inquiry list.\
> \---\
> \## Detailed Description\
> \* Retrieves the list of 1:1 inquiries submitted by the member to Customer Center.\
> \* Retrieves the count of 1:1 inquiries submitted by the member to Customer Center.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"paths":{"/v1/member/memberMgmt/getCustomerCenter":{"get":{"tags":["Member Information Management"],"summary":"Retrieve Customer Center 1:1 Inquiry List","description":"## Function Description\n* Retrieves the member's Customer Center 1:1 Inquiry list.\n---\n## Detailed Description\n* Retrieves the list of 1:1 inquiries submitted by the member to Customer Center.\n* Retrieves the count of 1:1 inquiries submitted by the member to Customer Center.\n","operationId":"getCustomerCenter","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CustomerCenterRequest"}},{"name":"CustomerCenterRequest","in":"query","description":"Customer Center 1:1 Inquiry List Retrieval Request","required":true,"schema":{"type":"string","description":"CustomerCenterRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseCustomerCenterResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"CustomerCenterRequest":{"type":"object","description":"Customer Center Retrieval Request","properties":{"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"mbrNm":{"type":"string","description":"Member Name"},"joinDt":{"type":"string","description":"Registration Date"}}},"RealGridListResponseCustomerCenterResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/CustomerCenterResponse"}}}},"CustomerCenterResponse":{"type":"object","description":"Customer Center Retrieval Response","properties":{"ccnNo":{"type":"string","description":"Consultation No."},"mbrNo":{"type":"string","description":"Member No."},"reqCtg":{"type":"string","description":"Inquiry Type"},"ccnPrgsStatCd":{"type":"string","description":"Processing Status Code"},"ccnPrgsStatNm":{"type":"string","description":"Processing Status"},"accpDtm":{"type":"string","description":"Consultation Received Date and Time"},"ansDtm":{"type":"string"},"accpTitle":{"type":"string","description":"Reception Title"},"hierarchyCustInqTypNm":{"type":"string","description":"Consultation Type"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}}}
```