---
title: "포인트 단건조회 API"
method: POST
path: "/benepia/point"
tags: ["benepia"]
---

# 포인트 단건조회 API

`POST /benepia/point`

API를 통해 베네피아 포인트(복지포인트)조회합니다.<br>
    사용자로부터 베네피아 계정 아이디, 비밀번호를 전달받아 보유중인 베네피아 포인트를 조회할 수 있습니다.<br>
    KCP를 통해서만 진행되므로 KCP사이트코드 발급이 필요합니다.

## Response `200`

베네피아 포인트 조회 완료

- BenepiaPointResponse — 베네피아 포인트 조회 정보. 바로 아래 BenepiaPoint structure를 확인하세요
  - `code` integer — 0이면 정상적인 조회, 0아닌 값이면 message를 확인해봐야 합니다
  - `message` string — code값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다
  - `response` BenepiaPointAnnotation
    - `point` integer — 베네피아 보유 포인트

## Other responses

- `401` — 인증 Token이 전달되지 않았거나 유효하지 않은 경우
- `500` — 베네피아 포인트 조회 실패

---

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