메시지 목록 조회
작성일 2026.03.01 | 수정일 2026.03.01
GET
/messages/v4/listQuery
messagesId— 메시지 아이디
messageIds— 복수 메시지 아이디 (JSON 배열 형식)
groupId— 그룹 아이디
to— 수신번호
from— 발신번호
type— 메시지 타입
statusCode— 상태코드
chat
type 허용 값
`SMS`, `LMS`, `MMS`, `ATA`, `CTA`, `CTI`, `RCS_SMS`, `RCS_LMS`, `RCS_MMS`, `RCS_TPL`, `RCS_LTPL`, `RCS_ITPL`, `FAX`, `VOICE`
날짜 범위
페이지네이션
고급 검색 (criteria / cond / value)
세 파라미터를 세트로 사용하여 복합 조건 검색이 가능합니다. 각 값은 콤마(`,`)로 구분합니다
criteria 허용 필드 및 지원 연산자
cond 연산자
요청 예시
GET /messages/v4/list?limit=10GET /messages/v4/list?to=01012345678GET /messages/v4/list?startDate=2024-01-01T00:00:00Z&endDate=2024-01-31T23:59:59ZGET /messages/v4/list?criteria=statusCode,type&cond=eq,eq&value=4000,SMSGET /messages/v4/list?startKey=M4V20240525163506XXXXXXXXXXXXXXX&limit=20Response
{
"messageList": {
"M4V20240525163506CQKNPHTPCX4P5E": {
"messageId": "M4V20240525163506CQKNPHTPCX4P5E",
"groupId": "G4V20240525163506ABCDEFGHIJKLMNO",
"accountId": "24010100001234",
"to": "01012345678",
"from": "0212345678",
"text": "테스트 메시지입니다.",
"type": "SMS",
"country": "82",
"status": "COMPLETE",
"statusCode": "4000",
"reason": "정상 처리",
"networkCode": "10001",
"networkName": "SKT",
"dateCreated": "2024-05-25T07:35:06.000Z",
"dateUpdated": "2024-05-25T07:35:10.000Z",
"dateReceived": "2024-05-25T07:35:10.000Z",
"replacement": false
}
},
"limit": 20,
"startKey": null,
"nextKey": "M4V20240525163500XXXXXXXXXXXXXXX"
}`messageList`는 배열이 아닌 messageId를 key로 하는 객체 형태입니다.
`nextKey`가 `null`이면 마지막 페이지입니다.
Structures
{
"startKey": "string|null",
"nextKey": "string",
"limit": "number",
"messageList": {
"<messageId>": {
"messageId": "string",
"groupId": "string",
"accountId": "string",
"to": "string",
"from": "string|null",
"text": "string",
"type": "string|null",
"country": "string",
"subject": "string|null",
"imageId": "string|null",
"customFields": "object",
"status": "string",
"statusCode": "string|null",
"networkCode": "string|null",
"replacement": "boolean",
"replacements": [
{
"to": "string",
"from": "string",
"text": "string",
"customFields": "object"
}
],
"autoTypeDetect": "boolean",
"unavailableSenderNumber": "boolean",
"faxPageCount": "number",
"resendCount": "number",
"voiceReplied": "number",
"voiceDuration": "number",
"queues": [
{
"name": "string",
"statusCode": "string|null",
"uniqId": "string|null"
}
],
"currentQueue": "string|null",
"dateProcessed": "date|null",
"dateReported": "date|null",
"dateReceived": "date|null",
"dateCreated": "date",
"dateUpdated": "date",
"log": [
{
"createAt": "date",
"message": "string"
}
],
"kakaoOptions": {
"pfId": "string",
"senderKey": "string",
"templateId": "string",
"templateCode": "string",
"title": "string",
"adFlag": "boolean",
"buttonName": "string",
"buttonUrl": "string",
"disableSms": "boolean",
"imageId": "string",
"buttons": [
{
"buttonName": "string",
"buttonType": "string",
"linkMo": "string",
"linkPc": "string",
"linkAnd": "string",
"linkIos": "string",
"chatExtra": "string",
"targetOut": "boolean"
}
],
"quickReplies": [
{
"name": "string",
"linkType": "string",
"linkMo": "string",
"linkPc": "string",
"linkAnd": "string",
"linkIos": "string",
"chatExtra": "string",
"targetOut": "boolean"
}
],
"header": "string",
"highlight": {
"title": "string",
"description": "string",
"imageId": "string"
},
"item": {
"list": [
{
"title": "string",
"description": "string"
}
],
"summary": {
"title": "string",
"description": "string"
}
}
},
"naverOptions": {
"talkId": "string",
"templateId": "string",
"disableSms": "boolean",
"buttons": [
{
"buttonCode": "string",
"buttonName": "string",
"buttonType": "string",
"linkMo": "string",
"linkPc": "string",
"linkAnd": "string",
"linkIos": "string"
}
]
},
"rcsOptions": {
"brandId": "string",
"templateId": "string",
"mmsType": "string",
"copyAllowed": "boolean",
"commercialType": "boolean",
"disableSms": "boolean",
"additionalBody": [
{
"title": "string",
"description": "string",
"imageId": "string",
"buttons": [
{
"buttonType": "string",
"buttonName": "string",
"link": "string",
"latitude": "string",
"longitude": "string",
"label": "string",
"query": "string",
"title": "string",
"startTime": "date",
"endTime": "date",
"text": "string",
"phone": "string"
}
]
}
],
"buttons": [
{
"buttonType": "string",
"buttonName": "string",
"link": "string",
"latitude": "string",
"longitude": "string",
"label": "string",
"query": "string",
"title": "string",
"startTime": "date",
"endTime": "date",
"text": "string",
"phone": "string"
}
]
},
"faxOptions": {
"fileIds": [
"string"
]
},
"voiceOptions": {
"voiceType": "string",
"headerMessage": "string",
"tailMessage": "string",
"replyRange": "number",
"counselorNumber": "string"
},
"reason": "string|null",
"networkName": "string"
}
}
}