더블스튜디오 콘솔 접속
공통 · 포인트 사용 내역

포인트 사용 내역

인증 워크스페이스의 포인트 사용 내역을 최신순으로 조회하는 API입니다.

인증이 필요한 요청에는 Accesskey · Secretkey 헤더를 첨부합니다. 공통 응답 형식과 에러 코드는 빠른 시작을 참고하세요.
GET /common/v1/points/history

포인트 사용 내역

인증 워크스페이스의 포인트 사용 내역을 최신순으로 조회하는 API입니다.

요청 파라미터

이름 타입 필수 기본값조건설명
page integer 선택 1 1 이상 페이지 번호입니다.
cnt integer 선택 10 1~20 페이지당 목록 개수입니다.
type integer 선택 - 0~4 조회할 사용 타입입니다.
  • 지정하지 않으면 전체 내역을 반환합니다.
  • 0—충전 내역만 조회합니다.
  • 1—차감 내역만 조회합니다.
  • 2—환불 내역만 조회합니다.
  • 3—만료 내역만 조회합니다.
  • 4—조정 내역만 조회합니다.

응답 파라미터

이름 타입 설명
traceId
string 요청 추적 ID입니다.
code
string 응답 코드입니다. 성공은 000000입니다.
message
string 응답 메시지입니다.
page
integer 현재 페이지입니다.
maxpage
integer 마지막 페이지입니다.
cnt
integer 반환 기준 개수입니다.
total
integer 조회 조건에 해당하는 전체 내역 수입니다.
  • type 을 지정하면 해당 타입 건수만, 지정하지 않으면 전체 건수입니다.
items 6개 필드
array 포인트 사용 내역 목록입니다.
  • type 을 지정하면 해당 타입 내역만 포함됩니다.
amount
number 증감 포인트입니다. 충전·환불은 양수, 차감·만료는 음수입니다.
balance
number 반영 후 잔액입니다.
type
integer 사용 타입 코드입니다.
  • 0—충전
  • 1—차감
  • 2—환불
  • 3—만료
  • 4—조정
type_name
string 사용 타입명입니다.
memo
string 내역 설명입니다.
create_dttm
datetime 발생 일시입니다.

요청 예시

예시 생성 중…

응답 예시 성공

{
  "traceId": "9f2c1a7b-4e0d-4b1a-8c2e-1f3a5d7b9c0e",
  "code": "000000",
  "message": "성공",
  "page": 1,
  "maxpage": 7,
  "cnt": 10,
  "total": 64,
  "items": [
    {
      "amount": -20.0,
      "balance": 152000.0,
      "type": 1,
      "type_name": "차감",
      "memo": "SMS 발송",
      "create_dttm": "2026-06-16 09:00:00"
    }
  ]
}