API

통계 일별 조회

작성일 2026.03.05 | 수정일 2026.03.05

GET/messages/v4/statistics/daily
Query
startDate— 조회 시작 일시 (ISO 8601)
endDate— 조회 종료 일시 (ISO 8601). 미지정 시 현재 시간
offset— 페이지 오프셋. 기본값: 0
limit— 한 번에 조회할 건수. 기본값: 20
taxIssued— 세금계산서 발행 여부로 필터링. 'true' 또는 'false'
profitSettlement— 수익 정산 완료 여부로 필터링. 'true' 또는 'false'
prepaid— 선불 결제 여부로 필터링. 'true' 또는 'false'
workspaceId— 워크스페이스 아이디로 필터링

일별 통계 원본 데이터를 페이지네이션으로 조회합니다. 통계 조회 API가 집계된 요약 데이터를 반환하는 것과 달리, 이 API는 개별 일자별 원본 레코드를 반환합니다.
세금계산서 발행 여부, 정산 여부, 선불 여부 등으로 필터링할 수 있어 정산 관련 데이터를 확인할 때 유용합니다.

요청 예시

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

Response

DailyStatistics 객체 배열이 반환됩니다. 최신 날짜순으로 정렬됩니다.

NameTypemustDescription
dailyStatsarray*일별 통계 목록
accountIdstring*계정 아이디
datestring*통계 날짜 (ISO 8601)
appIdstring|null*앱 아이디. 앱을 통한 발송이 아닌 경우 null
prepaidboolean*선불 결제 여부
countobject*메시지 타입별, 상태 코드별 발송 건수
balancenumber*해당 일 잔액(캐시) 사용 금액
pointnumber*해당 일 포인트 사용량
taxIssuedboolean*세금계산서 발행 여부
profitSettlementboolean*수익 정산 완료 여부
profitnumber*앱 수익 금액
refundobject*환불 내역
balancenumber*환불된 잔액
pointnumber*환불된 포인트
masterAccountIdstring|null*마스터 계정 아이디. 서브 계정인 경우에만 값이 존재
workspaceIdstring|null*워크스페이스 아이디

Structure

Response
[ { "accountId": "23010100000001", "date": "2026-01-15T00:00:00.000Z", "appId": null, "prepaid": true, "count": { "4000": { "sms": 160, "lms": 65, "ata": 100 }, "5004": { "sms": 2, "ata": 1 } }, "balance": 4500, "point": 100, "taxIssued": false, "profitSettlement": false, "profit": 0, "refund": { "balance": 20, "point": 0 }, "masterAccountId": null, "workspaceId": null }, { "accountId": "23010100000001", "date": "2026-01-14T00:00:00.000Z", "appId": null, "prepaid": true, "count": { "4000": { "sms": 140, "lms": 50, "ata": 90 } }, "balance": 3800, "point": 80, "taxIssued": false, "profitSettlement": false, "profit": 0, "refund": { "balance": 0, "point": 0 }, "masterAccountId": null, "workspaceId": null } ]