---
title: "포인트 내역 및 잔액 조회"
method: GET
path: "/v2/point/points"
tags: ["Point"]
---

# 포인트 내역 및 잔액 조회

`GET /v2/point/points`

사용자의 포인트 사용 내역과 현재 잔액을 조회합니다. 포인트 적립, 단가 차감, 만료 내역 등을 시간순으로 확인할 수 있어 계정 관리에 활용할 수 있습니다.

## Response `200`

포인트 내역 및 잔액 조회가 성공적으로 완료되었습니다. 현재 잔액과 포인트 사용 내역이 반환됩니다.

- PointsListResponseDto
  - `code` number, required — HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.
  - `message` string, required — API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "OK", 실패 시 구체적인 오류 사유가 포함됩니다.
  - `data` PointsListResponse, required
    - `points` PointsList[], required — 사용자의 포인트 목록 데이터입니다. 각 포인트 타입별 상세 정보가 포함됩니다.
      - `general` PointDetails, required
        - `points` number, required — 사용자의 현재 포인트 잔액입니다. 메시지 발송 시 차감되는 포인트 금액을 나타냅니다.
        - `credits` number — 사용자의 현재 크레딧 잔액입니다. 포인트와 별도로 관리되는 크레딧 금액을 나타냅니다.
        - `costId` number — 포인트 사용과 관련된 단가 정보 ID입니다.
        - `pointId` number, required — 포인트 계정 ID입니다.
        - `channelId` number — 포인트가 적용되는 채널 ID입니다.
        - `userId` number, required — 포인트 소유자 ID입니다.
        - `createdAt` string, date-time — 포인트 계정이 생성된 날짜와 시간입니다.
        - `updatedAt` string, date-time — 포인트 계정 정보가 마지막으로 수정된 날짜와 시간입니다.
    - `cursor` number — 다음 페이지를 요청할 때 사용할 커서 오프셋 값입니다. 더 이상 데이터가 없으면 null이 됩니다.

---

[API](https://skmtc.net/sendon/apis/sendon-api.md) · [All operations](https://skmtc.net/sendon/apis/sendon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendon/sendon-api/revisions/525dedc81a05/schema)