보유 배지 목록 조회<br/>(지갑 조회)

GET

/wallet/badges

이메일을 기준으로 수령자가 보유한 배지 목록을 조회합니다. 마이페이지 등에서 보유하고 있는 배지 목록을 표시할 때 사용하세요.

Authorizations

ApiKeyAuth

Type

API Key (header: X-API-Key)

요청 파라미터

필드명	위치	타입	필수 여부	기본값	설명
email	query	string	Required	-	수령인(홀더) 이메일 (필수)
page	query	integer	Optional	1	조회할 페이지 번호 (미전달 시 1)
rows_per_page	query	integer	Optional	20	페이지당 항목 수 (미전달 시 20, 최대 100)
sort_by	query	array<string>	Optional	-	정렬 컬럼명. 여러 개 지정 시 파라미터를 반복합니다 (예: `sort_by=reg_date&sort_by=title`).
sort_type	query	array<string>	Optional	-	정렬 방향. `sort_by`와 같은 순서로 반복합니다 (예: `sort_type=desc`).

Responses

보유 배지 목록

Content-Type

application/json

{

  

"code": "0001",

  

"message": "요청 성공하였습니다.",

  

"data": {

  

  

"list": [

  

  

  

{

  

  

  

  

"badge_id": "0QY4B3HP11FHQ",

  

  

  

  

"front_image_url": "/api/cmmn/link/eed3a547e4f/N56goWdJ48Xi.png",

  

  

  

  

"back_image_url": "/api/cmmn/link/13f2512cac8/fwXedDVauVbS.png",

  

  

  

  

"recipient_name": "홍길동",

  

  

  

  

"title": "창의 부트캠프 수료",

  

  

  

  

"issuing_org": "다인리더스",

  

  

  

  

"status_name": "발급완료",

  

  

  

  

"valid_from": "2026-07-08",

  

  

  

  

"valid_until": null,

  

  

  

  

"issued_at": "2026-07-08 16:13:12",

  

  

  

  

"reg_date": "2026-07-08 16:13:12"

  

  

  

}

  

  

],

  

  

"total_count": 1,

  

  

"page": 1,

  

  

"rows_per_page": 20

  

}

}

GET

/wallet/badges

Samples