メッセージ送信結果の照会

Classic/VPC環境で利用できます。

メッセージの送信結果を照会します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

リクエストヘッダ

Simple & Easy Notification Service APIで共通して使用されるヘッダの詳細は、Simple & Easy Notification Serviceのリクエストヘッダをご参照ください。

リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

リクエスト例

リクエストのサンプルコードは次の通りです。

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

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

messages

messagesの説明は次の通りです。

files

filesの説明は次の通りです。

レスポンスステータスコード

Simple & Easy Notification Service APIで共通して使用されるレスポンスステータスコードの詳細は、Simple & Easy Notification Serviceのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "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受信結果コードは次の3つに分類されます。

• IB G/W Report Code: 通信キャリアにメッセージ送信後に返された結果コード
• IB G/W Response Code: 中継会社のゲートウェイがメッセージ受信後に返す結果コード
• IB EMMA: EMMAがメッセージ送信リクエスト処理中に発生したエラーコード

IB G/W Report Code

IB G/W Reportコード別の説明は次の通りです。

IB G/W Response Code

IB G/W Responseコード別の説明は次の通りです。

IB EMMA

IB EMMAコード別の説明は次の通りです。