API

통계 조회

작성일 2026.03.05 | 수정일 2026.03.05

GET/messages/v4/statistics

Query

startDate— 조회 시작 일시 (ISO 8601). 미지정 시 가장 오래된 데이터부터 조회

endDate— 조회 종료 일시 (ISO 8601). 미지정 시 현재 시간까지 조회

masterAccountId— 마스터 계정 아이디. 서브 계정의 통계를 마스터 계정 기준으로 조회할 때 사용. 요청 계정과 동일한 값이어야 함

appId— 솔라피 앱스토어에 등록된 앱 아이디. 특정 앱을 통한 발송 통계만 조회할 때 사용. 본인이 등록한 앱만 조회 가능

targetAccountId— 대상 계정 아이디. appId와 함께 사용하여 특정 계정의 앱 사용 통계를 조회

지정한 기간 동안의 발송 통계를 종합적으로 조회합니다. 일별/월별 발송 건수, 성공/실패 비율, 메시지 타입별 사용량, 과금 내역 등을 한 번에 확인할 수 있습니다.
대시보드 화면을 구성하거나 발송 현황을 한눈에 파악할 때 유용합니다.

요청 예시

GET /messages/v4/statistics?startDate=2026-01-01T00:00:00Z&endDate=2026-01-31T23:59:59Z

Response

Name	Type	must	Description
balance	number	*	조회 기간 내 총 잔액(캐시) 사용 금액
point	number	*	조회 기간 내 총 포인트 사용량
monthlyBalanceAvg	number	*	월 평균 잔액 사용 금액
monthlyPointAvg	number	*	월 평균 포인트 사용량
dailyBalanceAvg	number	*	일 평균 잔액 사용 금액
dailyPointAvg	number	*	일 평균 포인트 사용량
dailyTotalCountAvg	number	*	일 평균 총 발송 건수
dailySuccessedCountAvg	number	*	일 평균 발송 성공 건수
dailyFailedCountAvg	number	*	일 평균 발송 실패 건수
refund	object	*	조회 기간 내 총 환불 내역
balance	number	*	환불된 잔액 합계
point	number	*	환불된 포인트 합계
total	object	*	메시지 타입별 총 발송 건수. sms, lms, mms, ata, cta, cti, nsa, rcs_sms, rcs_lms, rcs_mms, rcs_tpl, rcs_itpl, rcs_ltpl, fax, voice, bms_text, bms_image, bms_wide 등 각각 number
successed	object	*	메시지 타입별 발송 성공 건수. total과 동일한 키 구조
failed	object	*	메시지 타입별 발송 실패 건수. total과 동일한 키 구조
monthPeriod	array	*	월별 통계 목록. 조회 기간이 여러 달에 걸칠 경우 월 단위로 분리
date	string	*	해당 월 (YYYY-MM 형식)
balance	number	*	해당 월 잔액 사용 금액
balanceAvg	number	*	해당 월 일 평균 잔액 사용 금액
point	number	*	해당 월 포인트 사용량
pointAvg	number	*	해당 월 일 평균 포인트 사용량
dayPeriod	array	*	해당 월의 일별 통계 배열. 최상위 dayPeriod와 동일한 구조
refund	object	*	해당 월 환불 내역
balance	number	*	환불된 잔액
point	number	*	환불된 포인트
total	object	*	해당 월 메시지 타입별 총 발송 건수
successed	object	*	해당 월 메시지 타입별 발송 성공 건수
failed	object	*	해당 월 메시지 타입별 발송 실패 건수
dayPeriod	array	*	일별 통계 목록
_id	string	*	일별 통계 고유 식별자
month	string	*	해당 월 (YYYY-MM 형식)
date	string	*	해당 날짜 (YYYY-MM-DD 형식)
balance	number	*	해당 일 잔액 사용 금액
point	number	*	해당 일 포인트 사용량
statusCode	object	*	상태 코드별 메시지 타입별 건수. 예: { "4000": { "sms": 50 }, "5004": { "sms": 2 } }
refund	object	*	해당 일 환불 내역
balance	number	*	환불된 잔액
point	number	*	환불된 포인트
total	object	*	해당 일 메시지 타입별 총 발송 건수
successed	object	*	해당 일 메시지 타입별 발송 성공 건수
failed	object	*	해당 일 메시지 타입별 발송 실패 건수

Structure

Response

{
  "balance": 125000,
  "point": 3000,
  "monthlyBalanceAvg": 125000,
  "monthlyPointAvg": 3000,
  "dailyBalanceAvg": 4032,
  "dailyPointAvg": 96,
  "dailyTotalCountAvg": 320,
  "dailySuccessedCountAvg": 315,
  "dailyFailedCountAvg": 5,
  "refund": {
    "balance": 500,
    "point": 0
  },
  "total": {
    "sms": 5000,
    "lms": 2000,
    "mms": 500,
    "ata": 3000,
    "cta": 100,
    "cti": 0,
    "nsa": 0,
    "rcs_sms": 0,
    "rcs_lms": 0,
    "rcs_mms": 0,
    "rcs_tpl": 0,
    "rcs_itpl": 0,
    "rcs_ltpl": 0,
    "fax": 0,
    "voice": 50,
    "bms_text": 0,
    "bms_image": 0,
    "bms_wide": 0,
    "bms_wide_item_list": 0,
    "bms_carousel_feed": 0,
    "bms_premium_video": 0,
    "bms_commerce": 0,
    "bms_carousel_commerce": 0
  },
  "successed": {
    "sms": 4950,
    "lms": 1980,
    "mms": 495,
    "ata": 2970,
    "cta": 98,
    "cti": 0,
    "nsa": 0,
    "rcs_sms": 0,
    "rcs_lms": 0,
    "rcs_mms": 0,
    "rcs_tpl": 0,
    "rcs_itpl": 0,
    "rcs_ltpl": 0,
    "fax": 0,
    "voice": 48,
    "bms_text": 0,
    "bms_image": 0,
    "bms_wide": 0,
    "bms_wide_item_list": 0,
    "bms_carousel_feed": 0,
    "bms_premium_video": 0,
    "bms_commerce": 0,
    "bms_carousel_commerce": 0
  },
  "failed": {
    "sms": 50,
    "lms": 20,
    "mms": 5,
    "ata": 30,
    "cta": 2,
    "cti": 0,
    "nsa": 0,
    "rcs_sms": 0,
    "rcs_lms": 0,
    "rcs_mms": 0,
    "rcs_tpl": 0,
    "rcs_itpl": 0,
    "rcs_ltpl": 0,
    "fax": 0,
    "voice": 2,
    "bms_text": 0,
    "bms_image": 0,
    "bms_wide": 0,
    "bms_wide_item_list": 0,
    "bms_carousel_feed": 0,
    "bms_premium_video": 0,
    "bms_commerce": 0,
    "bms_carousel_commerce": 0
  },
  "monthPeriod": [
    {
      "date": "2026-01",
      "balance": 125000,
      "balanceAvg": 4032,
      "point": 3000,
      "pointAvg": 96,
      "dayPeriod": [],
      "refund": {
        "balance": 500,
        "point": 0
      },
      "total": {
        "sms": 5000,
        "lms": 2000,
        "mms": 500,
        "ata": 3000,
        "cta": 100,
        "cti": 0,
        "nsa": 0,
        "rcs_sms": 0,
        "rcs_lms": 0,
        "rcs_mms": 0,
        "rcs_tpl": 0,
        "rcs_itpl": 0,
        "rcs_ltpl": 0,
        "fax": 0,
        "voice": 50,
        "bms_text": 0,
        "bms_image": 0,
        "bms_wide": 0,
        "bms_wide_item_list": 0,
        "bms_carousel_feed": 0,
        "bms_premium_video": 0,
        "bms_commerce": 0,
        "bms_carousel_commerce": 0
      },
      "successed": {
        "sms": 4950,
        "lms": 1980,
        "mms": 495,
        "ata": 2970,
        "cta": 98,
        "cti": 0,
        "nsa": 0,
        "rcs_sms": 0,
        "rcs_lms": 0,
        "rcs_mms": 0,
        "rcs_tpl": 0,
        "rcs_itpl": 0,
        "rcs_ltpl": 0,
        "fax": 0,
        "voice": 48,
        "bms_text": 0,
        "bms_image": 0,
        "bms_wide": 0,
        "bms_wide_item_list": 0,
        "bms_carousel_feed": 0,
        "bms_premium_video": 0,
        "bms_commerce": 0,
        "bms_carousel_commerce": 0
      },
      "failed": {
        "sms": 50,
        "lms": 20,
        "mms": 5,
        "ata": 30,
        "cta": 2,
        "cti": 0,
        "nsa": 0,
        "rcs_sms": 0,
        "rcs_lms": 0,
        "rcs_mms": 0,
        "rcs_tpl": 0,
        "rcs_itpl": 0,
        "rcs_ltpl": 0,
        "fax": 0,
        "voice": 2,
        "bms_text": 0,
        "bms_image": 0,
        "bms_wide": 0,
        "bms_wide_item_list": 0,
        "bms_carousel_feed": 0,
        "bms_premium_video": 0,
        "bms_commerce": 0,
        "bms_carousel_commerce": 0
      }
    }
  ],
  "dayPeriod": [
    {
      "_id": "2026-01-15",
      "month": "2026-01",
      "date": "2026-01-15",
      "balance": 4500,
      "point": 100,
      "statusCode": {
        "4000": {
          "sms": 160,
          "lms": 65,
          "ata": 100
        },
        "5004": {
          "sms": 2,
          "ata": 1
        }
      },
      "refund": {
        "balance": 20,
        "point": 0
      },
      "total": {
        "sms": 162,
        "lms": 65,
        "mms": 15,
        "ata": 101,
        "cta": 3,
        "cti": 0,
        "nsa": 0,
        "rcs_sms": 0,
        "rcs_lms": 0,
        "rcs_mms": 0,
        "rcs_tpl": 0,
        "rcs_itpl": 0,
        "rcs_ltpl": 0,
        "fax": 0,
        "voice": 2,
        "bms_text": 0,
        "bms_image": 0,
        "bms_wide": 0,
        "bms_wide_item_list": 0,
        "bms_carousel_feed": 0,
        "bms_premium_video": 0,
        "bms_commerce": 0,
        "bms_carousel_commerce": 0
      },
      "successed": {
        "sms": 160,
        "lms": 65,
        "mms": 15,
        "ata": 100,
        "cta": 3,
        "cti": 0,
        "nsa": 0,
        "rcs_sms": 0,
        "rcs_lms": 0,
        "rcs_mms": 0,
        "rcs_tpl": 0,
        "rcs_itpl": 0,
        "rcs_ltpl": 0,
        "fax": 0,
        "voice": 2,
        "bms_text": 0,
        "bms_image": 0,
        "bms_wide": 0,
        "bms_wide_item_list": 0,
        "bms_carousel_feed": 0,
        "bms_premium_video": 0,
        "bms_commerce": 0,
        "bms_carousel_commerce": 0
      },
      "failed": {
        "sms": 2,
        "lms": 0,
        "mms": 0,
        "ata": 1,
        "cta": 0,
        "cti": 0,
        "nsa": 0,
        "rcs_sms": 0,
        "rcs_lms": 0,
        "rcs_mms": 0,
        "rcs_tpl": 0,
        "rcs_itpl": 0,
        "rcs_ltpl": 0,
        "fax": 0,
        "voice": 0,
        "bms_text": 0,
        "bms_image": 0,
        "bms_wide": 0,
        "bms_wide_item_list": 0,
        "bms_carousel_feed": 0,
        "bms_premium_video": 0,
        "bms_commerce": 0,
        "bms_carousel_commerce": 0
      }
    }
  ]
}