Get message delivery result

Available in Classic and VPC

Get the message delivery result.

Request

This section describes the request format. The method and URI are as follows:

Request headers

For information about the headers common to all Simple & Easy Notification Service APIs, see Simple & Easy Notification Service request headers.

Request path parameters

You can use the following path parameters with your request:

Request example

The request example is as follows:

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}' 

Response

This section describes the response format.

Response body

The response body includes the following data:

messages

The following describes messages.

files

The following describes files.

Response status codes

For information about the HTTP status codes common to all Simple & Easy Notification Service APIs, see Simple & Easy Notification Service response status codes.

Response example

The response example is as follows:

{
    "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": "When using a number subscribed to a caller ID spoofing prevention add-on service through a mobile carrier as the caller ID"
        }
    ]
}

Reception result code

EMMA v3.5.1 and later versions use these codes to indicate the delivery status of SMS messages after transmission. EMMA delivery status codes are categorized into the following three types:

• IB G/W report code: Result code returned after sending a message to the mobile carrier
• IB G/W response code: Result code returned after the relay gateway receives the message
• IB EMMA: Error code generated during EMMA's processing of the message delivery request

IB G/W Report Code

The following describes each IB G/W report code.

IB G/W Response Code

The following describes each IB G/W response code.

IB EMMA

The following describes each IB EMMA code.