관리자 API쿠폰 관리소유자 토큰

쿠폰 이용 내역

발급된 쿠폰 한 장 한 장을 읽습니다. 상품 목록처럼 쪽 번호 · 상태 · 회원 · 쿠폰번호 · 발급일로 거르고 정렬합니다.

업데이트됨 10.16 — 쿠폰 이용 내역이 상품 목록처럼 쪽 번호 · 조건 · 정렬을 받습니다

이용 내역

GEThttps://api.mallstory.kr/v1/shop/{shop_unique}/coupons/issues

권한 promotions:read

발급된 쿠폰 한 장 한 장입니다. 상품 목록과 같은 모양으로 쪽 번호 · 조건 · 정렬을 받습니다. 쿠폰 하나만 보려면 /coupons/{coupon_unique}/issues 로 부르거나 coupon_unique 를 쿼리로 보냅니다. 회원 이름 · 아이디는 싣지 않습니다 — member_unique 로 회원 상세(customers:read)에서 읽습니다.

쿼리	형식	설명
`page`	number	쪽 번호(1부터, 기본 1)
`size`	number	쪽당 건수(기본 20, 최대 100)
`coupon_unique`	string	이 쿠폰에서 나간 장만. 경로로 쿠폰을 가리키면 쓰지 않음
`status`	string	장의 상태 하나. EXPIRED 는 기한이 지난 보유 — 읽는 시각으로 가름 코드값
`member_unique`	string	이 회원이 받은 장만
`serial`	string	이 쿠폰번호로 받은 장(대소문자 무시). 번호 하나가 누구에게 갔는지 찾을 때
`keyword`	string	쿠폰명 · 쿠폰번호에 든 글자
`issued_from · issued_to`	YYYY-MM-DD	발급일 범위. 시작일 0시부터 종료일 끝까지(한국 시각). 한쪽만 보내도 됨
`sort`	string	정렬 키. 빼면 `issued_at` 내림차순(최근 발급순) 코드값
`order`	string	정렬 방향. 빼면 `desc`. `sort` 와 함께 보냅니다 — 혼자 보내면 400 코드값

bash요청

curl 'https://api.mallstory.kr/v1/shop/6a9515bdcb3ab5179ba767ad/coupons/issues?status=HOLD&issued_from=2026-09-01&size=20' \
  -H 'Authorization: Bearer msat_8Hk2wQ7...'

json200 OK

{
  "items": [
    {
      "issue_unique": "6ab334793ee1d2fe347cdcfc",
      "coupon_unique": "6ab31f913ee1d2fe347cdcf2",
      "name": "쿠폰 테스트 할인 10%",
      "status": "HOLD",
      "serial": "카카오테스트",
      "member_unique": "6a9a8a6449a0e88a2212027f",
      "member_no": 1,
      "discount": "10% (최대 10,000원)",
      "issued_at": "2026-09-23T02:07:53.513Z",
      "expire_at": "2026-10-23T14:59:59.999Z",
      "used_at": ""
    }
  ],
  "page": 1,
  "size": 20,
  "total": 1,
  "has_more": false
}

응답 필드

필드	형식	설명
`items`	array	발급된 장. 아래 필드
`items[].issue_unique`	string	발급된 한 장의 키
`items[].coupon_unique`	string	어느 쿠폰에서 나왔나
`items[].name`	string	발급될 때 베껴 둔 쿠폰명
`items[].coupon_type · min_order_amount`	string	발급될 때 베껴 둔 쿠폰 종류 · 최소 주문금액. 쿠폰을 나중에 고쳐도 이 값은 그대로
`items[].status`	string	HOLD 보유 · USED 사용 · EXPIRED 만료(기한이 지난 보유) 코드값
`items[].serial`	string	받을 때 적은 쿠폰번호. 번호 없이 받았으면 빈 글자
`items[].member_unique · member_no`	string	받은 회원
`items[].discount`	string	그 장의 할인(글) — 예: 3,000원 · 10% (최대 5,000원)
`items[].issued_at · expire_at · used_at`	ISO	발급 · 만료 · 사용 시각(쓰지 않았으면 used_at 은 빈 글자)
`page`	number	지금 쪽 번호
`size`	number	쪽당 건수
`total`	number	조건에 맞는 전체 건수
`has_more`	boolean	다음 쪽이 있는가

바뀐 장만 가져가려면 sort=used_at 으로 사용 시각순으로 읽거나 issued_from 으로 발급일을 좁힙니다.
같은 시각의 장은 키 차례로 세워 쪽을 넘겨도 같은 줄이 두 번 오지 않습니다.

오류

상태	code	언제
400	`InvalidParameterValue`	status · sort · order 가 목록에 없음 · 날짜 모양이 아님 · member_unique 가 키 모양이 아님
404	`CouponNotExist`	쿠폰 하나로 볼 때 없는 키
401	`MissingLoginSession`	Authorization 헤더에 Bearer 토큰이 없음
401	`InvalidAccessToken`	토큰이 틀리거나 만료 · 폐기됨
403	`InsufficientScope`	토큰에 promotions:read 가 없음

이용 내역#

응답 필드

오류

이용 내역