발급이력 목록 조회

GET

/badges/history

배지 발급이력을 조회합니다. 수령인 이름·이메일, 배지 제목, 발급일·회수일 범위로 필터링합니다. 발급·회수 요청의 처리 결과를 확인할 때 사용하십시오.

Authorizations

ApiKeyAuth

Type

API Key (header: X-API-Key)

요청 파라미터

필드명	위치	타입	필수 여부	기본값	설명
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`).
recipient_name	query	string	Optional	-	수령인 이름 필터
recipient_email	query	string	Optional	-	수령인 이메일 필터
title	query	string	Optional	-	배지 제목 필터
issue_start_date	query	string · date	Optional	-	발급 시작일
issue_end_date	query	string · date	Optional	-	발급 종료일
revoke_start_date	query	string · date	Optional	-	회수 시작일
revoke_end_date	query	string · date	Optional	-	회수 종료일

Responses

발급이력 목록

Content-Type

application/json

{

  

"code": "0001",

  

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

  

"data": {

  

  

"list": [

  

  

  

{

  

  

  

  

"badge_id": "0QY4B3HP11FHQ",

  

  

  

  

"template_id": "TPL00000000005",

  

  

  

  

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

  

  

  

  

"badge_type_name": "참여",

  

  

  

  

"category_name": "내부훈련",

  

  

  

  

"level": 2,

  

  

  

  

"level_name": "중급",

  

  

  

  

"recipient_name": "홍길동",

  

  

  

  

"recipient_email": "mq1p24m8@kakao.com",

  

  

  

  

"status_name": "발급완료",

  

  

  

  

"email_status": "SENT",

  

  

  

  

"issuing_org": "미래대학교",

  

  

  

  

"valid_until": null,

  

  

  

  

"issued_at": "2027-01-03 05:36:43",

  

  

  

  

"reg_date": "2027-01-03 05:36:40",

  

  

  

  

"revoke_at": null

  

  

  

}

  

  

],

  

  

"total_count": 1,

  

  

"page": 1,

  

  

"rows_per_page": 20

  

}

}

GET

/badges/history

Samples