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

쿠폰 목록, 개수 조회

get

기능설명

• 쿠폰의 목록과 개수를 조회 합니다.

---

상세설명

• 검색조건에 맞는 쿠폰 목록과 개수를 조회합니다. 검색조건은 아래와 같습니다.

  • 쿠폰 유효기간

  • 쿠폰유형

  • 사용여부

  • 기간만료 여부

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

memberNostringRequired

Query parameters

argSelectTypestring · min: 1Required

선택구분 1: 단일, N: 다중

Example: 1

mbrNostringRequired

회원번호

Example: 10000001

startDatestring · date-timeRequired

시작일자

endDatestring · date-timeRequired

종료일자

useYNstringOptional

사용여부 Y: 사용, N: 미사용

Example: Y

promoDivstringRequired

쿠폰조회 구분코드 Y: 무료배송/반품쿠폰, N: 쿠폰

Example: Y

expiredCdstringOptional

기간만료조회코드 10: 기간유효, 20: 기간만료

Example: 10

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/member/{memberNo}/coupons

HTTPcURLJavaScriptPython

GET /api/bo/v2/member/{memberNo}/coupons?argSelectType=1&mbrNo=10000001&startDate=2026-02-27T20%3A07%3A48.212Z&endDate=2026-02-27T20%3A07%3A48.212Z&promoDiv=Y HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T20:07:48.212Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "totalCount": 1,
    "payloads": [
      {
        "cpnIsuNo": "0000001",
        "mbrNo": 10000001,
        "useYn": "Y",
        "ordNo": "20230808O007404",
        "ordSeq": 1,
        "promoNo": "C1000001",
        "promoNm": "쿠폰명",
        "promoTypCd": 11,
        "promoTypNm": "상품할인쿠폰",
        "validDtm": "text",
        "useDtm": "2026-02-27T20:07:48.212Z",
        "useGbCd": "01",
        "useGbNm": "주문사용",
        "dcRateAmt": 1000,
        "fixamtFxrtGbCd": "01",
        "fixamtFxrtGbNm": "정액",
        "expiredYn": "Y"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}