> 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). # 회원이 보유한 쿠폰 조회 팝업 ## 쿠폰 목록, 개수 조회 > \## 기능설명\ > \* 쿠폰의 목록과 개수를 조회 합니다.\ > \---\ > \## 상세설명\ > \* 검색조건에 맞는 쿠폰 목록과 개수를 조회합니다. 검색조건은 아래와 같습니다.\ > \* 쿠폰 유효기간\ > \* 쿠폰유형\ > \* 사용여부\ > \* 기간만료 여부
```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"}}}}}}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://tech.x2bee.com/api/back-office-api/popup-bo-api/undefined-9.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.