API

국가별 메시지 단가 목록 조회

작성일 2026.03.14 | 수정일 2026.03.14

GET/pricing/v1/messaging/countries

Query

countryId— 특정 국가 코드로 필터링. 미지정 시 전체 국가 목록 반환.

serviceMethod— 서비스 종류. MT 또는 AUTH (기본값: MT)

withoutProfit— true이면 앱 수익금을 제외한 단가를 반환합니다 (기본값: false)

offset— 조회 시작 위치 (기본값: 0)

limit— 한 번에 조회할 최대 건수 (기본값: 20)

서비스 종류와 국가별 메시지 단가 목록을 조회합니다. 로그인하지 않아도 호출할 수 있으며, 로그인 상태에서는 사용자별 조정 단가가 반영됩니다.

Response

Name	Type	Required	Description
countryId	string	*	국가 코드 (예: '82', '1', '670')
countryName	string	*	국가명 (영문)
serviceMethod	string	*	서비스 종류. 'MT' 또는 'AUTH'
sms	number	*	SMS 단가 (원)
lms	number	*	LMS 단가 (원)
mms	number	*	MMS 단가 (원)
ata	number	*	카카오 알림톡 단가 (원)
cta	number	*	카카오 친구톡 단가 (원)
cti	number	*	카카오 친구톡 이미지 단가 (원)
rcs_sms	number		RCS SMS 단가 (원). 설정된 경우에만 포함됩니다.
rcs_lms	number		RCS LMS 단가 (원). 설정된 경우에만 포함됩니다.
nsa	number		네이버 스마트알림 단가 (원). 설정된 경우에만 포함됩니다.
bms_text	number		브랜드 메시지 텍스트형 단가 (원). 설정된 경우에만 포함됩니다.
bms_wide	number		브랜드 메시지 와이드형 단가 (원). 설정된 경우에만 포함됩니다.
dateCreated	string	*	단가 생성일시 (ISO 8601)
dateUpdated	string	*	단가 수정일시 (ISO 8601)

Structure

Response

[
  {
    "countryId": "82",
    "countryName": "Korea, South",
    "serviceMethod": "MT",
    "sms": 20,
    "lms": 50,
    "mms": 200,
    "ata": 19,
    "cta": 13,
    "cti": 20,
    "dateCreated": "2024-01-15T09:00:00.000Z",
    "dateUpdated": "2024-06-01T12:00:00.000Z"
  },
  {
    "countryId": "1",
    "countryName": "United States",
    "serviceMethod": "MT",
    "sms": 50,
    "lms": 50,
    "mms": 200,
    "ata": 19,
    "cta": 13,
    "cti": 20,
    "dateCreated": "2024-01-15T09:00:00.000Z",
    "dateUpdated": "2024-06-01T12:00:00.000Z"
  },
  {
    "countryId": "670",
    "countryName": "East Timor",
    "serviceMethod": "MT",
    "sms": 180,
    "lms": 500,
    "mms": 1000,
    "ata": 19,
    "cta": 13,
    "cti": 20,
    "dateCreated": "2024-01-15T09:00:00.000Z",
    "dateUpdated": "2024-06-01T12:00:00.000Z"
  }
]