> 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/popup-bo-api/member-coupon-lookup-popup.md).

# Member Coupon Lookup Popup

## Retrieve Coupon List and Count

> \## Function Description\
> \* Retrieves the coupon list and count.\
> \---\
> \## Detailed Description\
> \* Retrieves the coupon list and count matching the search conditions. The search conditions are as follows.\
>   \* Coupon validity period\
>   \* Coupon type\
>   \* Usage status\
> &#x20; \* Expiration 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":{"/v2/member/{memberNo}/coupons":{"get":{"tags":["Member Coupon Lookup Popup"],"summary":"Retrieve Coupon List and Count","description":"## Function Description\n* Retrieves the coupon list and count.\n---\n## Detailed Description\n* Retrieves the coupon list and count matching the search conditions. The search conditions are as follows.\n  * Coupon validity period\n  * Coupon type\n  * Usage status\n  * Expiration status\n","operationId":"getCouponListByMember","parameters":[{"name":"memberNo","in":"path","required":true,"schema":{"type":"string"}},{"name":"argSelectType","in":"query","description":"Selection Type 1: Single, N: Multiple","required":true,"schema":{"type":"string","description":"Selection Type 1: Single, N: Multiple","minLength":1}},{"name":"mbrNo","in":"query","description":"Member No.","required":true,"schema":{"type":"string","description":"Member No."}},{"name":"promoTypCd","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","description":"Promotion Type Code (MK002)\n 11 : Product Discount Coupon\n, 12 : Cart Coupon\n, 13 : Stackable Discount Coupon\n, 14 : Free Shipping Coupon\n, 15 : Free Return Coupon\n, 20 : Employee Discount\n, 21 : Instant Product Discount\n, 40 : Product Mileage\n","enum":["11","12","13","14","15","20","21","40"]}}},{"name":"startDate","in":"query","description":"Start Date","required":true,"schema":{"type":"string","format":"date-time","description":"Start Date"}},{"name":"endDate","in":"query","description":"End Date","required":true,"schema":{"type":"string","format":"date-time","description":"End Date"}},{"name":"useYN","in":"query","description":"Usage Status Y: In Use, N: Not in Use","required":false,"schema":{"type":"string","description":"Usage Status Y: In Use, N: Not in Use"}},{"name":"promoDiv","in":"query","description":"Coupon Search Type Code Y: Free Shipping/Return Coupon, N: Coupon","required":true,"schema":{"type":"string","description":"Coupon Search Type Code Y: Free Shipping/Return Coupon, N: Coupon"}},{"name":"expiredCd","in":"query","description":"Period Expiration Search Code 10: Valid Period, 20: Expired Period","required":false,"schema":{"type":"string","description":"Period Expiration Search Code 10: Valid Period, 20: Expired Period"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseOrderClaimCoupon"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ResponseRealGridListResponseOrderClaimCoupon":{"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":{"$ref":"#/components/schemas/RealGridListResponseOrderClaimCoupon","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseOrderClaimCoupon":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OrderClaimCoupon"}}}},"OrderClaimCoupon":{"type":"object","properties":{"cpnIsuNo":{"type":"string","description":"Coupon Issuance No.","minLength":1},"mbrNo":{"type":"string","description":"Member No.","minLength":1},"useYn":{"type":"string","description":"Usage Status"},"ordNo":{"type":"string","description":"Order No."},"ordSeq":{"type":"string","description":"Order Sequence No."},"promoNo":{"type":"string","description":"Coupon No."},"promoNm":{"type":"string","description":"Coupon Name"},"promoTypCd":{"type":"string","description":"Coupon Type","enum":["11","12","13","14","15","20","21","40"]},"promoTypNm":{"type":"string","description":"Coupon Type Name"},"validDtm":{"type":"string","description":"Validity Period"},"useDtm":{"type":"string","format":"date-time","description":"Usage Date/Time"},"useGbCd":{"type":"string","description":"Usage Type Code"},"useGbNm":{"type":"string","description":"Usage Type Name"},"dcRateAmt":{"type":"number","description":"Discount Amount"},"fixamtFxrtGbCd":{"type":"string","description":"Discount (Flat Rate/Percentage) Type Code","enum":["01","02"]},"fixamtFxrtGbNm":{"type":"string","description":"Discount (Flat Rate/Percentage) Type Code Name"},"expiredYn":{"type":"string","description":"Period Expiration Status"}},"required":["cpnIsuNo","mbrNo"]},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"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"}}}}}}}
```