> 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/back-office-api/popup-bo-api/undefined-9.md).

# 회원이 보유한 쿠폰 조회 팝업

## 쿠폰 목록, 개수 조회

> \## 기능설명\
> \* 쿠폰의 목록과 개수를 조회 합니다.\
> \---\
> \## 상세설명\
> \* 검색조건에 맞는 쿠폰 목록과 개수를 조회합니다. 검색조건은 아래와 같습니다.\
>   \* 쿠폰 유효기간\
>   \* 쿠폰유형\
>   \* 사용여부\
> &#x20; \* 기간만료 여부<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":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"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":"쿠폰발급번호","minLength":1},"mbrNo":{"type":"string","description":"회원번호","minLength":1},"useYn":{"type":"string","description":"사용여부"},"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"string","description":"주문순번"},"promoNo":{"type":"string","description":"쿠폰번호"},"promoNm":{"type":"string","description":"쿠폰명"},"promoTypCd":{"type":"string","description":"쿠폰유형","enum":["11","12","13","14","15","20","21","40"]},"promoTypNm":{"type":"string","description":"쿠폰유형명"},"validDtm":{"type":"string","description":"유효기간"},"useDtm":{"type":"string","format":"date-time","description":"사용일시"},"useGbCd":{"type":"string","description":"사용구분코드"},"useGbNm":{"type":"string","description":"사용구분명"},"dcRateAmt":{"type":"number","description":"할인금액"},"fixamtFxrtGbCd":{"type":"string","description":"할인(정액/정율)구분 코드","enum":["01","02"]},"fixamtFxrtGbNm":{"type":"string","description":"할인(정액/정율)구분 코드명"},"expiredYn":{"type":"string","description":"기간만료 여부"}},"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"}}}}}},"paths":{"/v2/member/{memberNo}/coupons":{"get":{"tags":["회원이 보유한 쿠폰 조회 팝업"],"summary":"쿠폰 목록, 개수 조회","description":"## 기능설명\n* 쿠폰의 목록과 개수를 조회 합니다.\n---\n## 상세설명\n* 검색조건에 맞는 쿠폰 목록과 개수를 조회합니다. 검색조건은 아래와 같습니다.\n  * 쿠폰 유효기간\n  * 쿠폰유형\n  * 사용여부\n  * 기간만료 여부\n","operationId":"getCouponListByMember","parameters":[{"name":"memberNo","in":"path","required":true,"schema":{"type":"string"}},{"name":"argSelectType","in":"query","description":"선택구분 1: 단일, N: 다중","required":true,"schema":{"type":"string","description":"선택구분 1: 단일, N: 다중","minLength":1}},{"name":"mbrNo","in":"query","description":"회원번호","required":true,"schema":{"type":"string","description":"회원번호"}},{"name":"promoTypCd","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","description":"프로모션 유형 코드(MK002)\n 11 : 상품할인쿠폰\n, 12 : 장바구니쿠폰\n, 13 : 중복할인쿠폰\n, 14 : 무료배송쿠폰\n, 15 : 무료반품쿠폰\n, 20 : 임직원할인\n, 21 : 상품즉시할인\n, 40 : 상품마일리지\n","enum":["11","12","13","14","15","20","21","40"]}}},{"name":"startDate","in":"query","description":"시작일자","required":true,"schema":{"type":"string","format":"date-time","description":"시작일자"}},{"name":"endDate","in":"query","description":"종료일자","required":true,"schema":{"type":"string","format":"date-time","description":"종료일자"}},{"name":"useYN","in":"query","description":"사용여부 Y: 사용, N: 미사용","required":false,"schema":{"type":"string","description":"사용여부 Y: 사용, N: 미사용"}},{"name":"promoDiv","in":"query","description":"쿠폰조회 구분코드 Y: 무료배송/반품쿠폰, N: 쿠폰","required":true,"schema":{"type":"string","description":"쿠폰조회 구분코드 Y: 무료배송/반품쿠폰, N: 쿠폰"}},{"name":"expiredCd","in":"query","description":"기간만료조회코드 10: 기간유효, 20: 기간만료","required":false,"schema":{"type":"string","description":"기간만료조회코드 10: 기간유효, 20: 기간만료"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseOrderClaimCoupon"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```