> 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/marketing-bo-api/interested-customer-information-management.md).
# Interested Customer Information Management
## Unregister Interested Customer
> \## Function Description\
> \* Unregisters the specified member from interested customers.\
> \---\
> \## Detailed Description\
> \* Processes a list of member numbers.
```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":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"InstCusRvcRequest":{"type":"object","description":"Interested Member Unregistration Request","properties":{"instMbrSeqList":{"type":"array","description":"Interested Member Sequence No. List","items":{"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"}}}}},"paths":{"/v1/member/instCusMgmt/rvcInstCus":{"post":{"tags":["Interested Customer Information Management"],"summary":"Unregister Interested Customer","description":"## Function Description\n* Unregisters the specified member from interested customers.\n---\n## Detailed Description\n* Processes a list of member numbers.\n","operationId":"rvcInstCus","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstCusRvcRequest"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Register Interested Customer
> \## Function Description\
> \* Registers the specified member as an interested customer.\
> \---\
> \## Detailed Description\
> \* Required value list\
> \* Member No.\
> \* Management Type Code\
> \* Management Category Code\
> \* Registration Reason
```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":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"EtInstMbrInfo":{"type":"object","description":"Interested Member Information Entity","properties":{"instMbrSeq":{"type":"string","description":"Watched Member Sequence No."},"mbrNo":{"type":"string","description":"Member No."},"mgrGbCd":{"type":"string","description":"Management Type Code (ME019)"},"mgrTypCd":{"type":"string","description":"Management Type Code (ME009)"},"ordNo":{"type":"string","description":"Order No."},"regCausCont":{"type":"string","description":"Registration Reason"},"mgrMbrRegId":{"type":"string","description":"Managed Member Registration ID"},"mgrMbrRegDtm":{"type":"string","format":"date-time","description":"Managed Member Registration Date and Time"},"mgrMbrRvcId":{"type":"string","description":"Managed Member Release ID"},"mgrMbrRvcDtm":{"type":"string","format":"date-time","description":"Managed Member Unregistration Date and 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"}}}}},"paths":{"/v1/member/instCusMgmt/regInstCus":{"post":{"tags":["Interested Customer Information Management"],"summary":"Register Interested Customer","description":"## Function Description\n* Registers the specified member as an interested customer.\n---\n## Detailed Description\n* Required value list\n * Member No.\n * Management Type Code\n * Management Category Code\n * Registration Reason\n","operationId":"regInstCus","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EtInstMbrInfo"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Check Existing Interested Customer Registration
> \## Function Description\
> \* Checks whether the specified member is registered as an interested customer.\
> \---\
> \## Detailed Description\
> \* Required value list\
> \* Member No.\
> \* Management Type Code
```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":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"EtInstMbrInfo":{"type":"object","description":"Interested Member Information Entity","properties":{"instMbrSeq":{"type":"string","description":"Watched Member Sequence No."},"mbrNo":{"type":"string","description":"Member No."},"mgrGbCd":{"type":"string","description":"Management Type Code (ME019)"},"mgrTypCd":{"type":"string","description":"Management Type Code (ME009)"},"ordNo":{"type":"string","description":"Order No."},"regCausCont":{"type":"string","description":"Registration Reason"},"mgrMbrRegId":{"type":"string","description":"Managed Member Registration ID"},"mgrMbrRegDtm":{"type":"string","format":"date-time","description":"Managed Member Registration Date and Time"},"mgrMbrRvcId":{"type":"string","description":"Managed Member Release ID"},"mgrMbrRvcDtm":{"type":"string","format":"date-time","description":"Managed Member Unregistration Date and 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"}}}}},"paths":{"/v1/member/instCusMgmt/getInstCusExist":{"post":{"tags":["Interested Customer Information Management"],"summary":"Check Existing Interested Customer Registration","description":"## Function Description\n* Checks whether the specified member is registered as an interested customer.\n---\n## Detailed Description\n* Required value list\n * Member No.\n * Management Type Code\n","operationId":"getInstCusExist","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EtInstMbrInfo"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Interested Customer Information List
> \## Function Description\
> \* Retrieves the interested customer information list according to the conditions selected on screen.\
> \---\
> \## Detailed Description\
> \* Retrieves the interested customer information list according to the conditions selected on screen.\
> \* The retrieved information is masked.\
> \* Masking list\
> \* Member Name\
> \* Mobile Phone No.\
> \* Member ID\
> \---\
> \## Revision History\
> \* Release v2.00\_240613: Improved period search condition
```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":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"InstCusRequest":{"type":"object","description":"Interested Customer Retrieval Request","properties":{"sysRegDtm":{"type":"string"},"sysRegId":{"type":"string"},"sysModDtm":{"type":"string"},"sysModId":{"type":"string"},"rowsPerPage":{"type":"integer","format":"int32"},"pageIdx":{"type":"integer","format":"int32"},"endPage":{"type":"boolean"},"mbrOpt":{"type":"string","description":"Request Type (NAME, ID, mbrNo)"},"mbrValue":{"type":"string","description":"Member Name, ID, or No."},"dateSelect":{"type":"string","description":"Full Period Search Status"},"regStrDt":{"type":"string","format":"date","description":"Registration Start Date"},"regEndDt":{"type":"string","format":"date","description":"Registration End Date"},"instMbrYn":{"type":"string","description":"Interested Customer Status"},"mgrGbCd":{"type":"string","description":"Management Classification"},"mgrTypCd":{"type":"string","description":"Management Type"},"ordLmtYn":{"type":"string","description":"Purchase Restriction Status"},"cellSctNo":{"type":"string","description":"Mobile Phone Exchange Code"},"cellTxnoNo":{"type":"string","description":"Mobile Phone Middle Number"},"cellEndNo":{"type":"string","description":"Mobile Phone Last Digits"},"langCd":{"type":"string","description":"Language Code (CM009)"},"regDt":{"type":"string","description":"Search Period Button"},"siteNo":{"type":"string","description":"Site No."}}},"RealGridListResponseInstCusResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/InstCusResponse"}}}},"InstCusResponse":{"type":"object","description":"Interested Customer Retrieval Response","properties":{"instMbrSeq":{"type":"string","description":"Watched Member Sequence No."},"mbrNo":{"type":"string","description":"Member No."},"mbrNm":{"type":"string","description":"Member Name"},"cellNo":{"type":"string","description":"Mobile Phone Number"},"loginId":{"type":"string","description":"Member ID"},"instMbrYn":{"type":"string","description":"Interested Customer Status"},"mgrGbNm":{"type":"string","description":"Management Type Name (ME019)"},"mgrTypNm":{"type":"string","description":"Management Category Name (ME009)"},"ordLmtYn":{"type":"string","description":"Purchase Restriction Status"},"regCausCont":{"type":"string","description":"Registration Reason"},"ordNo":{"type":"string","description":"Order No."},"mgrMbrRegDt":{"type":"string","format":"date","description":"Managed Member Registration Date"},"mgrMbrRegId":{"type":"string","description":"Managed Member Registration ID"},"mgrMbrRvcDt":{"type":"string","format":"date","description":"Managed Member Unregistration Date"},"mgrMbrRvcId":{"type":"string","description":"Managed Member Release ID"},"siteNm":{"type":"string","description":"Site 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"}}}}},"paths":{"/v2/member/instCusMgmt/getInstCusList":{"get":{"tags":["Interested Customer Information Management"],"summary":"Retrieve Interested Customer Information List","description":"## Function Description\n* Retrieves the interested customer information list according to the conditions selected on screen.\n---\n## Detailed Description\n* Retrieves the interested customer information list according to the conditions selected on screen.\n* The retrieved information is masked.\n* Masking list\n * Member Name\n * Mobile Phone No.\n * Member ID\n---\n## Revision History\n* Release v2.00_240613: Improved period search condition\n","operationId":"getInstCusList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/InstCusRequest"}},{"name":"mbrOpt","in":"query","description":"Request Type (NAME, ID, mbrNo)","schema":{"type":"string"}},{"name":"mbrValue","in":"query","description":"Member Name, ID, or No.","schema":{"type":"string"}},{"name":"dateSelect","in":"query","description":"Search Full Period Search Status","schema":{"type":"string"}},{"name":"regStrDt","in":"query","description":"Registration Start Date","schema":{"type":"string"}},{"name":"regEndDt","in":"query","description":"Registration End Date","schema":{"type":"string"}},{"name":"instMbrYn","in":"query","description":"Interested Customer Status","schema":{"type":"string"}},{"name":"mgrGbCd","in":"query","description":"Management Classification","schema":{"type":"string"}},{"name":"mgrTypCd","in":"query","description":"Management Type","schema":{"type":"string"}},{"name":"ordLmtYn","in":"query","description":"Purchase Restriction Status","schema":{"type":"string"}},{"name":"cellSctNo","in":"query","description":"Mobile Phone Exchange Code","schema":{"type":"string"}},{"name":"cellTxnoNo","in":"query","description":"Mobile Phone Middle Number","schema":{"type":"string"}},{"name":"cellEndNo","in":"query","description":"Mobile Phone Last Digits","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseInstCusResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```