---
title: "메시지 발송 결과 조회"
slug: "sens-sms-get"
updated: 2026-07-23T09:04:26Z
published: 2026-07-23T09:04:26Z
canonical: "api.ncloud-docs.com/sens-sms-get"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 메시지 발송 결과 조회

Classic/VPC 환경에서 이용 가능합니다.

메시지 발송 결과를 조회합니다.

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| GET | /sms/v2/services/{serviceId}/messages/{messageId} |

### 요청 헤더

Simple & Easy Notification Service API에서 공통으로 사용하는 헤더에 대한 정보는 [Simple & Easy Notification Service 요청 헤더](/docs/sens-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `serviceId` | String | Required | SMS 서비스 아이디 - [프로젝트 목록 조회](/docs/sens-project-list) 참조 |
| `messageId` | String | Required | 메시지 아이디 - [메시지 발송 목록 조회](/docs/sens-sms-list) 참조 |

### 요청 예시

요청 예시는 다음과 같습니다.

```
curl --location --request GET 'https://sens.apigw.ntruss.com/sms/v2/services/ncp:sms:kr:50*********1:sens/messages/f574d3f0-****-****-****-daa31f50eaf5' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
```

## 응답

응답 형식을 설명합니다.

### 응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `statusCode` | String | - | 상태 코드 - HTTP 상태 코드 규칙을 따름 - `200`: 성공 - 그 외: 실패 |
| `statusName` | String | - | 상태 - `success` \| `reserved` \| `fail` - `success`: 성공 - `reserved`: 예약 - `fail`: 실패 |
| `messages` | Array | - | 메시지 정보: [messages](/docs/sens-sms-get#messages) |

#### `messages`

`messages`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `requestId` | String | - | 요청 아이디 |
| `messageId` | String | - | 메시지 아이디 |
| `requestTime` | String | - | 요청 일시 - YYYY-MM-dd HH:mm:ss 형식 |
| `contentType` | String | - | 메시지 콘텐츠 타입 - `COMM` \| `AD` - `COMM`: 일반용 - `AD`: 광고용 |
| `type` | String | - | 메시지 타입 - `SMS` \| `LMS` \| `MMS` - `SMS`: SMS 메시지 - `LMS`: LMS 메시지 - `MMS`: MMS 메시지 |
| `subject` | String | - | 메시지 제목 |
| `content` | String | - | 메시지 내용 |
| `countryCode` | String | - | 국가 코드 |
| `from` | String | - | 발신 번호 |
| `to` | String | - | 수신 번호 |
| `completeTime` | String | - | 완료 일시 - YYYY-MM-dd HH:mm:ss 형식 |
| `telcoCode` | String | - | 통신사 코드 |
| `files` | Array | - | 첨부 파일 목록: [files](/docs/sens-sms-get#files) |
| `status` | String | - | 요청 상태 - `READY` \| `PROCESSING` \| `COMPLETED` - `READY`: 대기중 - `PROCESSING`: 처리중 - `COMPLETED`: 완료 |
| `statusCode` | String | - | [수신 결과 코드](/docs/sens-sms-get#%EC%88%98%EC%8B%A0%EA%B2%B0%EA%B3%BC%EC%BD%94%EB%93%9C) |
| `statusName` | String | - | 수신 상태 - `success` \| `fail` - `success`: 성공 - `fail`: 실패 |
| `statusMessage` | String | - | 수신 상태 메시지 |

#### `files`

`files`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `fileId` | String | - | 파일 아이디 |
| `name` | String | - | 파일 이름 |

### 응답 상태 코드

Simple & Easy Notification Service API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Simple & Easy Notification Service 응답 상태 코드](/docs/sens-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

### 응답 예시

응답 예시는 다음과 같습니다.

```
{
    "statusCode": "200",
    "statusName": "success",
    "messages": [
        {
            "requestId": "RSMA-*************-****-********-ijYyjJqS",
            "messageId": "f574d3f0-****-****-****-daa31f50eaf5",
            "requestTime": "2025-11-25 10:17:00",
            "contentType": "COMM",
            "type": "MMS",
            "subject": "Delivery",
            "content": "Hello, ******. This is for notifying your delivery status.",
            "countryCode": "82",
            "from": "010********",
            "to": "010********",
            "completeTime": "2025-11-25 10:17:00",
            "telcoCode": "ETC",
            "files": [
                {
                    "fileId": "a136************************74f7",
                    "name": "G0ufjqMy3wBpCucJenTaU.jpg"
                }
            ],
            "status": "COMPLETED",
            "statusCode": "3018",
            "statusName": "fail",
            "statusMessage": "휴대폰 가입 이동통신사를 통해 발신번호 변작 방지 부가 서비스에 가입된 번호를 발신번호로 사용하는 경우"
        }
    ]
}
```

## 수신 결과 코드

EMMA v3.5.1 이상에서 SMS 메시지 전송 후 수신 결과를 나타내는 코드입니다. EMMA 수신 결과 코드는 다음 세 가지로 구분됩니다.

- IB G/W Report Code: 이통사에 메시지를 전송한 후 반환되는 결과 코드
- IB G/W Response Code: 중계사 게이트웨이가 메시지를 수신한 후 반환하는 결과 코드
- IB EMMA: EMMA가 메시지 전송 요청을 처리하는 과정에서 발생한 오류 코드

### IB G/W Report Code

IB G/W Report 코드별 설명은 다음과 같습니다.

| 코드 | 분류 | 설명 |
| --- | --- | --- |
| 0 | success | 성공 |
| 2000 | failure | 전송 시간 초과 |
| 2001 | failure | 전송 실패 (무선망단) |
| 2002 | failure | 전송 실패 (무선망 > 단말기단) |
| 2003 | failure | 단말기 전원 꺼짐 |
| 2004 | failure | 단말기 메시지 버퍼 풀 |
| 2005 | failure | 음영지역 |
| 2006 | failure | 메시지 삭제됨 |
| 2007 | failure | 일시적인 단말 문제 |
| 3000 | Invalid | 전송할 수 없음 |
| 3001 | Invalid | 가입자 없음 |
| 3002 | Invalid | 성인 인증 실패 |
| 3003 | Invalid | 수신 번호 형식 오류 |
| 3004 | Invalid | 단말기 서비스 일시 정지 |
| 3005 | Invalid | 단말기 호 처리 상태 |
| 3006 | Invalid | 착신 거절 |
| 3007 | Invalid | Callback URL을 받을 수 없는 폰 |
| 3008 | Invalid | 기타 단말기 문제 |
| 3009 | Invalid | 메시지 형식 오류 |
| 3010 | Invalid | MMS 미지원 단말 |
| 3011 | Invalid | 서버 오류 |
| 3012 | Invalid | 스팸 |
| 3013 | Invalid | 서비스 거부 |
| 3014 | Invalid | 기타 |
| 3015 | Invalid | 전송 경로 없음 |
| 3016 | Invalid | 첨부 파일 사이즈 제한 실패 |
| 3017 | Invalid | 발신 번호 변작 방지 세칙 위반 |
| 3018 | Invalid | 발신 번호 변작 방지 서비스에 가입된 휴대폰 개인가입자 번호 |
| 3019 | Invalid | KISA 또는 미래부에서 모든 고객사에 대하여 차단 처리 요청한 발신 번호 |
| 3022 | Invalid | Charset Conversion Error |
| 3023 | Invalid | 발신 번호 사전등록제를 통해 등록되지 않은 번호 |

### IB G/W Response Code

IB G/W Response 코드별 설명은 다음과 같습니다.

| 코드 | 설명 |
| --- | --- |
| 1001 | Server Busy (RS 내부 저장 Queue Full) |
| 1002 | 수신 번호 형식 오류 |
| 1003 | 회신번호 형식 오류 |
| 1004 | 스팸 |
| 1005 | 사용 건수 초과 |
| 1006 | 첨부 파일 없음 |
| 1007 | 첨부 파일 있음 |
| 1008 | 첨부 파일 저장 실패 |
| 1009 | CLIENT_MSG_KEY 없음 |
| 1010 | CONTENT 없음 |
| 1011 | CALLBACK 없음 |
| 1012 | RECIPIENT_INFO 없음 |
| 1013 | SUBJECT 없음 |
| 1014 | 첨부 파일 키 없음 |
| 1015 | 첨부 파일 이름 없음 |
| 1016 | 첨부 파일 크기 없음 |
| 1017 | 첨부 파일 Content 없음 |
| 1018 | 전송 권한 없음 |
| 1019 | TTL 초과 |
| 1020 | charset conversion error |
| S000 | 중계사 요청 실패 (서버 오류) |
| S001 | 중계사 요청 실패 (서버 오류) |
| S002 | 중계사 요청 실패 (잘못된 요청) |
| S003 | 중계사 요청 실패 (스팸 처리) |
| S004 | 쿼터 초과 |
| S005 | 잘못된 MMS 파일 |
| S006 | MMS 파일을 찾을 수 없음 |
| S007 | MMS 파일 만료 |
| S008 | MMS 파일 크기 초과 |
| S009 | MMS 파일 해상도 초과 |
| S010 | MMS 파일 업로드 쿼터 초과 |
| S011 | MMS 파일 업로드 실패 |
| S012 | 발신 번호 세칙 오류 |
| S998 | 예기치 못한 서버 오류 |
| S999 | 기타 오류 |

### IB EMMA

IB EMMA 코드별 설명은 다음과 같습니다.

| 코드 | 설명 |
| --- | --- |
| E900 | Invalid-IB 전송키가 없는 경우 |
| E901 | 수신 번호가 없는 경우 |
| E902 | 동보인 경우, 수신 번호 순번이 없는 경우 |
| E903 | 제목이 없는 경우 |
| E904 | 메시지가 없는 경우 |
| E905 | 회신번호가 없는 경우 |
| E906 | 메시지 키가 없는 경우 |
| E907 | 동보 여부가 없는 경우 |
| E908 | 서비스 타입이 없는 경우 |
| E909 | 전송 요청 시각이 없는 경우 |
| E910 | TTL 타임이 없는 경우 |
| E911 | 서비스 타입이 MMS MT인 경우, 첨부 파일 확장자가 없는 경우 |
| E912 | 서비스 타입이 MMS MT인 경우, attach_file 폴더에 첨부 파일이 없는 경우 |
| E913 | 서비스 타입이 MMS MT인 경우, 첨부 파일 사이즈가 0인 경우 |
| E914 | 서비스 타입이 MMS MT인 경우, 메시지 테이블에는 파일 그룹 키가 있는데 파일 테이블에 데이터가 없는 경우 |
| E915 | 중복 메시지 |
| E916 | 인증 서버 차단 번호 |
| E917 | 고객 DB 차단 번호 |
| E918 | USER CALLBACK FAIL |
| E919 | 발송 제한 시간인 경우, 메시지 재발송 처리가 금지된 경우 |
| E920 | 서비스 타입이 LMS MT인 경우, 메시지 테이블에 파일 그룹 키가 있는 경우 |
| E921 | 서비스 타입이 MMS MT인 경우, 메시지 테이블에 파일 그룹 키가 없는 경우 |
| E922 | 동보 단어 제약 문자 사용 오류 |
| E999 | 기타 오류 |