---
title: "서비스 단가 정보 조회"
method: GET
path: "/v2/point/costs"
tags: ["Point"]
---

# 서비스 단가 정보 조회

`GET /v2/point/costs`

현재 사용자에게 할당된 문자 발송 서비스 단가 정보를 조회합니다. SMS, LMS, MMS 등 메시지 타입별 단가와 발송 비용을 확인할 수 있어 메시지 발송 전 비용 예측에 활용할 수 있습니다.

## Response `200`

사용자의 단가 정보 조회가 성공적으로 완료되었습니다. 할당된 단가에 따른 메시지 타입별 비용 정보가 반환됩니다.

- CostGetResponseDto
  - `code` number, required — HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.
  - `message` string, required — API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "OK", 실패 시 구체적인 오류 사유가 포함됩니다.
  - `data` CostGetResponse, required
    - `costName` string, required — 단가 이름입니다.
    - `costDisplayName` string, required — 사용자에게 표시되는 단가의 표기명입니다. 웹사이트나 앱에서 사용자에게 보여지는 단가 이름입니다.
    - `daysValid` number, required — 단가 설정의 유효기간을 일 단위로 나타냅니다. 0은 무제한을 의미하며, 설정된 일수 이후에는 단가가 만료됩니다.
    - `pricings` MessagePricing[], required — 메시지 유형별 단가 정보 목록입니다. SMS, LMS, MMS 각각에 대한 개별 단가를 설정할 수 있습니다.
      - `messageType` 'SMS' | 'LMS' | 'MMS' | 'AT' | 'AI' | 'AE' | 'AL' | 'FT' | 'FI' | 'FW' | 'FWL' | 'FCF' | 'FPV' | 'FCM' | 'FCC' | 'BMT' | 'BMI' | 'BMW' | 'BMWL' | 'BMCF' | 'RcsSMS' | 'RcsLMS' | 'RcsMMS' | 'RcsTSM' | 'RcsTLM' | 'RcsTMM', required — 단가가 적용되는 메시지의 종류입니다. SMS, LMS, MMS 중 선택할 수 있으며, 각 메시지 유형별로 다른 단가를 설정할 수 있습니다.
      - `pricing` number, required — 해당 메시지 유형의 단가입니다. 메시지 1건당 차감되는 포인트 금액을 나타냅니다.
    - `costId` number, required — 포인트 사용과 관련된 단가 정보 ID입니다.
    - `startDate` string, date-time — 단가 설정이 적용되기 시작하는 날짜와 시간입니다. 이 시점부터 단가가 유효하게 됩니다.
    - `endDate` string, date-time — 단가 설정이 적용되는 마지막 날짜와 시간입니다. 이 시점 이후에는 단가가 만료됩니다.
    - `createdAt` string, date-time — 단가 설정이 생성된 날짜와 시간입니다.
    - `updatedAt` string, date-time — 단가 설정이 마지막으로 수정된 날짜와 시간입니다.

---

[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)