단건 발송내역 리스트 상세결과 조회 (전체 성공 / 실패 카운트 포함)
API 목록
GET
/v1/openapi/message/single-groups-with-counts
단건 발송내역 리스트 상세결과 조회 API
1. 단건 발송내역 리스트 상세결과 조회 API
수신자가 한명인 단건 발송그룹만 조회됩니다.
발송 내역은 항상 msgGrpNo기준 내림차순으로 정렬됩니다
SMS/LMS/MMS만 조회가 가능합니다.
발송 일시 범위를 지정해야 하며, 결과 수신일(cpl---Date)을 기준으로 조회할 시 더 빠른 조회가 가능합니다.
GEThttps://api.megabird.co.kr:8080/v1/openapi/message/single-groups-with-counts
1.1 Query String Parameters
svcKndCd
String
N
서비스 유형코드 : SMS, LMS, MMS
SMS
msgSndStsCd
String
N
문자 발송 상태코드 : [''] 전체, [MGD] 진행중, [MGC] 완료
MGC
keyword
String
N
검색어 ( 메시지 제목 / 카카오 채널 ID / 발신번호 )
메가버드
snPhnum
String
N
발신전화번호
01012345678
tagList
List<String>
N
메세지 그룹 태그 목록 여러개의 태그를 전송시 OR 조건으로 검색하여 해당 태그를 가지고 있는 메시지 그룹들만 반환됩니다
"태그1", "태그2"
sndBeginDate
String
Y (발송일시 범위 또는 결과수신 범위중 1가지는 반드시 지정해야합니다)
발송일시 시작일 날짜 범위는 최대 한달
2022-10-04
sndEndDate
String
Y (발송일시 범위 또는 결과수신 범위중 1가지는 반드시 지정해야합니다)
발송일시 종료일 날짜 범위는 최대 한달
2022-10-09
cplBeginDate
String
Y (발송일시 범위 또는 결과수신 범위중 1가지는 반드시 지정해야합니다)
결과수신 시작일 날짜 범위는 최대 한달
2022-10-04
cplEndDate
String
Y (발송일시 범위 또는 결과수신 범위중 1가지는 반드시 지정해야합니다)
결과수신 종료일 날짜 범위는 최대 한달
2022-10-09
mbnum
String
N
수신전화번호
01012345678
pageSize
Integer
N
한번에 조회할 목록 수 ( Default : 100 )
1
lastSeenId
Long
N
마지막으로 확인된 메시지 그룹 아이디
100
1.2 Request Example
1.3 Response Body Parameters
code
String
성공코드
1.3.1 result (응답데이터)
totalCount
Integer
전체 조회 수
totalMessageCount
Integer
전체 메시지 수
successMessageCount
Integer
전체 성공 메시지 수
failMessageCount
Integer
전체 실패 메시지 수
hasNext
Boolean
다음 결과 데이터 존재 유무
lastSeenId
Long
마지막 메시지 그룹번호
1.3.2 result (발송그룹 상세 결과 리스트)
msgGrpNo
Long
메시지그룹번호
snPhnum
String
발신전화번호
chnId
String
카카오 채널 아이디 (카카오 발송의 경우)
msgTtl
String
메시지제목
msgCotn
String
메시지내용
messageId
String
메시지 아이디
mblnum
String
수신자 휴대폰번호
svcKndCd
String
서비스종류코드 [SMS], [LMS], [MMS]
svcKndCdNm
String
서비스종류코드명
sndStsCd
String
수신자 발송상태코드 (MTC / MTF)
sndStsCdNm
String
수신자 발송상태코드명 sndStsCd 값에 따라 (MTC : 발송완료 / MTF : 발송실패)
regDtt
String
등록일시
sndCplDtt
String
발송완료일시
tagList
List<String>
태그 목록
msgMetaData
JSON
[메타데이터] 원하는 데이터 자유롭게 넣어서 사용 가능하며 최대 1KB 제한
1.4 Response Example
{
"code": "0000",
"result": {
"totalCount": 3,
"totalMessageCount": 3,
"successMessageCount": 0,
"failMessageCount": 3,
"result": [
{
"msgGrpNo": 3244185,
"snPhnum": "12341234",
"chnId": null,
"msgTtl": "hellohellohellohellohellohellohellohellohellohellohelloworld",
"msgCotn": "stage api lms 치환변수 test #{이름}, #{1}, #{2}, #{3}, #{4}",
"messageId": "03b8b5f4aadb4f45b676ad71e6b8f3c6",
"mblnum": "01012341234",
"svcKndCd": "LMS",
"svcKndCdNm": "LMS",
"sndStsCd": "MTF",
"sndStsCdNm": "발송실패",
"sndRstCd": "9999",
"sndStsCzCmt": "내부 타임아웃(96시간)",
"regDtt": "2025-04-22T20:04:47",
"sndCplDtt": "2025-04-24T20:16:53",
"tagList":[]
},
{
"msgGrpNo": 3244183,
"snPhnum": "12341234",
"chnId": null,
"msgTtl": "",
"msgCotn": "stage authsms",
"messageId": "8213cada4aef471a91a387a854fc4fe9",
"mblnum": "01012341234",
"svcKndCd": "AUTHSMS",
"svcKndCdNm": "인증SMS",
"sndStsCd": "MTF",
"sndStsCdNm": "발송실패",
"sndRstCd": "9999",
"sndStsCzCmt": "내부 타임아웃(96시간)",
"regDtt": "2025-04-22T20:04:14",
"sndCplDtt": "2025-04-24T20:13:51",
"tagList":[]
},
{
"msgGrpNo": 3244182,
"snPhnum": "12341234",
"chnId": null,
"msgTtl": "",
"msgCotn": "stage authsms",
"messageId": "bc3aa39292a841818943318554e04927",
"mblnum": "01012341234",
"svcKndCd": "AUTHSMS",
"svcKndCdNm": "인증SMS",
"sndStsCd": "MTF",
"sndStsCdNm": "발송실패",
"sndRstCd": "9999",
"sndStsCzCmt": "내부 타임아웃(96시간)",
"regDtt": "2025-04-22T19:58:54",
"sndCplDtt": "2025-04-24T20:02:23",
"tagList":[]
}
],
"hasNext": false,
"lastSeenId": 3244182
}
}1.5 상세 발송 결과 코드 (sndRstCd/sndStsCzCmt)
공통
sndRstCd sndStsCzCmt
5 내용 형식 오류
33 전화번호 형식 오류
37 일반문자 수신거부 차단
300 Invalid Receiver Phone Number
301 Spam checked
302 Receiver Ban Phone Number
303 Callback Ban Phone Number
304 Spam checked
400 Format Error
500 Failure
912 080 수신거부 차단
7100 내부 타임아웃(72시간)
7301 스미싱 차단
7401 사전 미등록 발신번호 사용
7402 전화번호 세칙 미준수 발신번호 사용
7777 ACK 미수신
8000 컨텐츠 에러
8100 JSON 포맷 에러
9000 알 수 없는 에러
9999 기타 에러
6001 잘못된 수신번호
6002 비 가입자, 결번, 서비스 정지
6003 번호 이동
6100 타임 아웃
6101 음영 지역
6102 전원 꺼짐
6103 메시지 저장 초과
6104 착신 거절
6105 단말기 BUSY
6106 단말기 일시정지
6107 단말기 착신거부
6108 서비스 불가 단말기
6109 핸드폰 호 불가 상태
6200 SMC 운영자가 삭제한 메시지
6201 통신사 형식 오류
6202 무선망단 실패
6300 스팸
6401 사전 미등록 발신번호 사용
6402 전화번호 세칙 미준수 발신번호 사용
6403 발신번호 변작으로 등록된 발신번호 사용
6404 번호도용문자차단서비스에 가입된 발신번호 사용
6410 미입력 식별코드 차단
6500 내부 형식 오류
6501 메시지의 길이 초과
6502 첨부파일 사이즈 초과
6600 기타 에러SMS
sndRstCd sndStsCzCmt
1000 성공
1001 스팸(과금성공)
2001 잘못된 수신번호
2002 비 가입자, 결번, 서비스 정지
2003 번호 이동
2100 타임 아웃
2101 음영 지역
2102 전원 꺼짐
2103 메시지 저장 초과
2104 착신 거절
2105 단말기 BUSY
2106 단말기 일시정지
2107 단말기 착신거부
2108 서비스 불가 단말기
2109 핸드폰 호 불가 상태
2200 SMC 운영자가 삭제한 메시지
2201 통신사 형식 오류
2202 무선망단 실패
2300 스팸
2401 사전 미등록 발신번호 사용
2402 전화번호 세칙 미준수 발신번호 사용
2403 발신번호 변작으로 등록된 발신번호 사용
2404 번호도용문자차단서비스에 가입된 발신번호 사용
2500 내부 형식 오류
2501 메시지의 길이 초과
2600 기타 에러LMS/MMS
sndRstCd sndStsCzCmt
1000 성공
1001 스팸(과금성공)
3001 잘못된 수신번호
3002 비 가입자, 결번, 서비스 정지
3003 번호 이동
3100 타임 아웃
3101 음영 지역
3102 전원 꺼짐
3103 메시지 저장 초과
3104 착신 거절
3105 단말기 BUSY
3106 단말기 일시정지
3107 단말기 착신거부
3108 서비스 불가 단말기
3109 핸드폰 호 불가 상태
3200 SMC 운영자가 삭제한 메시지
3201 통신사 형식 오류
3202 무선망단 실패
3300 스팸
3401 사전 미등록 발신번호 사용
3402 전화번호 세칙 미준수 발신번호 사용
3403 발신번호 변작으로 등록된 발신번호 사용
3404 번호도용문자차단서비스에 가입된 발신번호 사용
3500 내부 형식 오류
3501 메시지의 길이 초과
3502 첨부파일 사이즈 초과
3600 기타 에러KKO
sndRstCd sndStsCzCmt
1000 성공
4001 잘못된 수신번호
4002 친구톡 전송 시 친구 대상 아님
4100 타임아웃
4200 Sender key (발신프로필키) 유효하지 않음
4201 Sender key (발신프로필키) 존재하지 않음
4202 삭제된 Sender key (발신프로필키)
4203 차단 상태 Sender key (발신프로필키)
4300 차단 상태 옐로우 아이디
4301 닫힌 상태 옐로우 아이디
4302 삭제된 옐로우 아이디
4400 템플릿 불일치
4401 템플릿 없음
4500 메시지가 존재하지 않음
4501 메시지 길이 초과
4502 메시지를 전송할 수 없음
4503 메시지 발송 불가 시간
4504 메시지 그룹 정보를 찾을 수 없음
4505 카카오 형식 오류
4506 카카오 시스템 오류
4600 기타 에러Last updated