---
title: "メールの詳細照会"
slug: "sens-mail-get"
updated: 2026-10-08T07:15:49Z
published: 2026-10-08T07:15:49Z
canonical: "api.ncloud-docs.com/sens-mail-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環境で利用できます。

送信リクエストに含まれたメール1件の詳細情報を照会します。メールの件名・本文、添付ファイルリスト、受信者ごとの送信結果(`recipients[]`)を併せて返します。

## リクエスト

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

| メソッド | URI |
| --- | --- |
| GET | /mail/v2/services/{serviceId}/requests/{requestId}/mails/{mailId} |

### リクエストヘッダ

Simple & Easy Notification Service APIで共通して使用されるヘッダの詳細は、[Simple & Easy Notification Serviceのリクエストヘッダ](/docs/ja/sens-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

| フィールド | 必須の有無 | 説明 |
| --- | --- | --- |
| `x-ncp-lang` | Optional | レスポンスメッセージの言語 - `en-US` (デフォルト)\| `ko-KR` \| `ja-JP` |

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

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `serviceId` | String | Required | メールサービス ID - NRN(NAVERクラウドプラットフォーム Resource Name)形式 (例: `ncp:mail:kr:1********2:main`) - [プロジェクトリストの照会](/docs/ja/sens-project-list)を参照 |
| `requestId` | String | Required | 送信リクエスト ID - [送信リクエストリストの照会](/docs/ja/sens-mail-request-list)を参照 |
| `mailId` | String | Required | メール ID - パス内の`requestId`に属しているメールであること - [メールリストの照会](/docs/ja/sens-mail-list)を参照 |

### リクエスト例

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

```
curl --location --request GET 'https://sens.apigw.ntruss.com/mail/v2/services/ncp:mail:kr:1********2:main/requests/20260712-R-01K0ZQ8YV3M4N5P6R7S8T9VAWX-777/mails/20260712-M-01K0ZQ8YVBQ7C2D3E4F5G6H7J8-777' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-lang: ko-KR'
```

## レスポンス

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

### レスポンスボディ

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `requestId` | String | - | 送信リクエスト ID |
| `mailId` | String | - | メール ID |
| `requesterIp` | String | - | 送信をリクエストしたクライアントの IPアドレス - コンソール送信および API送信の両方で、リクエスト時の送信元アドレスを記録 |
| `createDateTime` | String | - | 送信リクエストの受付日時 - ISO 8601形式 |
| `title` | String | - | メール件名 - 置換変数が実際の値に置き換えられた結果 |
| `templateNo` | Integer | - | 使用されたテンプレート番号 - テンプレートを使用していない送信の場合は`null` |
| `templateName` | String | - | 使用されたテンプレートの名前 - テンプレートを使用していない送信の場合は`null` |
| `status` | String | - | メール送信状態 - `READY` \| `RESERVED` \| `SENDING` \| `COMPLETED` \| `FAILED` \| `PARTIAL_FAILED` \| `CANCELED` - `READY`: 送信開始を待機中 - `RESERVED`: 予約した送信時間を待機中 - `SENDING`: メール送信中 - `COMPLETED`: メールに属する全受信者への送信が完了 - `FAILED`: メールに属する全受信者への送信が失敗 - `PARTIAL_FAILED`: メールに属する一部受信者への送信が失敗 - `CANCELED`: 送信がキャンセルされた |
| `senderAddress` | String | - | 送信者のメールアドレス |
| `senderName` | String | - | 送信者の名前 - 入力していない送信の場合は`null` |
| `sendDateTime` | String | - | 送信完了日時 - ISO 8601形式 - 送信が開始されていないメールの場合は`null` |
| `reservationDateTime` | String | - | 予約送信日時 - ISO 8601形式 - 即時送信は`null` |
| `body` | String | - | メール本文 - 置換変数が実際の値に置き換えられた結果 - `advertising`が`true`の場合、受信拒否の文言を含む |
| `advertising` | Boolean | - | 広告メールかどうか - `true` \| `false` |
| `attachFiles` | Array | - | 添付ファイルリスト: [attachFiles](/docs/ja/sens-mail-get#attachfiles) - 添付ファイルがない場合は空の配列 |
| `recipients` | Array | - | 受信者別送信結果リスト: [recipients](/docs/ja/sens-mail-get#recipients) - `CC`、`BCC`受信者を含む - 一般送信の場合、受信者を30人単位で分割してメールを作成するため、項目数は最大30 - 個別送信の場合、受信者ごとにメールが1件であるため、項目数は1 |

#### `attachFiles`

`attachFiles`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `fileId` | String | - | 添付ファイル ID |
| `fileName` | String | - | 添付ファイル名 - 最大100文字 |
| `fileSize` | Integer | - | 添付ファイルサイズ(Byte) |

#### `recipients`

`recipients`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `address` | String | - | 受信者のメールアドレス |
| `name` | String | - | 受信者名 - 未記入の受信者は`null` |
| `type` | String | - | 受信者タイプ - `TO` \| `CC` \| `BCC` - `TO`: 宛先 - `CC`: CC - `BCC`: BCC |
| `received` | Boolean | - | 受信の確認 - `true` \| `false` - `true`: 受領者がメールを閲覧した - `false`: 閲覧していない |
| `receivedDateTime` | String | - | 受信確認日時 - (ISO 8601形式) - 閲覧していない場合は`null` |
| `status` | String | - | 受信者別送信状態 - `READY` \| `RESERVED` \| `SENDING` \| `RETRYING` \| `COMPLETED` \| `FAILED` \| `ERRORED` \| `UNSUBSCRIBED` \| `BLOCKED` \| `CANCELED` - `READY`: 送信開始を待機中 - `RESERVED`: 予約された送信時刻を待機中 - `SENDING`: 受信者へのメール送信を試行中 - `RETRYING`: 一時的な失敗により再試行が予約され待機中 - `COMPLETED`: 受信者へ正常にメールが送信された - `FAILED`: 受信サーバの拒否などにより送信失敗 - `ERRORED`: 送信処理中にエラーで終了 - `UNSUBSCRIBED`: 受信拒否アドレスのため送信されない - `BLOCKED`: 送信ブロックアドレスのため送信されない - `CANCELED`: 送信がキャンセルされた |
| `retryCount` | Integer | - | 送信再試行回数 - 初回送信は再試行回数に含まれない |
| `sendResultCode` | String | - | 送信結果コード - 全体の値は[sendResultCode](/docs/ja/sens-mail-get#sendresultcode)を参照 - 値が追加される可能性があるオープンセット - 送信が完了していない受信者は`null` |
| `sendResultMessage` | String | - | 送信結果の原文メッセージ - 受信メールサーバが返した SMTPレスポンスの原文 - 送信が完了していない受信者は`null` |

#### `sendResultCode`

`recipients[].sendResultCode`の説明は次の通りです。

| コード | 説明 |
| --- | --- |
| `CANCELED_MAIL` | 送信のキャンセル |
| `CONNECTION_ABNORMAL` | 接続異常による一時的な送信失敗 |
| `CONTENT_HAS_TAG_FORM` | メールコンテンツ内に置換タグが存在したため、送信失敗 |
| `DKIM_FAIL` | DKIMエラーによりメール送信失敗 |
| `EMPTY_BODY_CONTENT` | システムエラーでメール本文を設定できなかったため、送信失敗 |
| `MAILBOX_ABNORMAL` | 受信者メールボックス異常による一時的な送信失敗 |
| `MAILBOX_ERROR` | 受信者メールボックスエラーによる送信失敗 |
| `MAIL_CONTENTS_ERROR` | メールコンテンツエラーによる送信失敗 |
| `MAIL_SENT` | 送信成功 |
| `MIME_MESSAGE_CREATE_FAIL` | システムエラーでMIMEメッセージを作成できなかったため、送信失敗 |
| `NETWORK_ABNORMAL` | ネットワーク異常による一時的な送信失敗 |
| `NETWORK_ERROR` | ネットワークエラーによる送信失敗 |
| `NONEXISTENT_DOMAIN_ADDRESS` | 受信者ドメインが存在しなかったため、送信失敗 |
| `RECEIVE_MAIL_SERVICE_ABNORMAL` | 受信者メールサービス異常による一時的な送信失敗 |
| `RECEIVE_MAIL_SERVICE_ERROR` | 受信者メールサービスエラーによる送信失敗 |
| `RECIPIENT_ADDRESS_ERROR` | 受信者アドレスエラーによる送信失敗 |
| `RESENDING_MAIL` | 再送信中 |
| `RESEND_MAIL_FAIL` | 再送信試行の超過による送信失敗 |
| `SECURITY_AND_POLICY_ABNORMAL` | セキュリティとポリシー異常による一時的な送信失敗 |
| `SECURITY_AND_POLICY_ERROR` | セキュリティとポリシーエラーによる送信失敗 |
| `SEND_BLOCK_ADDRESS` | 送信遮断された受信者に対して送信リクエストして遮断 |
| `SMTP_ABNORMAL` | 受信側とのSMTP異常による一時的な送信失敗 |
| `SMTP_ERROR` | 受信側とのSMTPエラーによる送信失敗 |
| `TEST_MAIL_SEND` | システムのテストメール送信 |
| `UNDEFINED_ERROR` | 定義されていないエラーによる送信失敗 |
| `UNKNOWN_CAUSE_FAIL` | システム内外で発生した不明なエラーによる送信失敗 |
| `UNKNOWN_DOMAIN_ADDRESS` | 不明なドメインまたは遮断されたドメインが含まれたアドレスに対して送信リクエストして失敗 |
| `UNSUBSCRIBE_ADDRESS` | 送信拒否したアドレスに対して送信リクエストして遮断 |
| `UNSUPPORTED_ENCODING_ADDRESS` | 受信者アドレスのエンコード失敗による送信失敗 |
| `READ_TIMED_OUT` | 受信サーバのレスポンスなしによる送信失敗 |
| `CONNECTION_ERROR` | 受信サーバの接続終了による送信失敗 |

              参考

              

- `mailId`はパス内の`requestId`に所属するメールである必要があります。権限のある呼び出し元に限り、所属していない場合は`404`を返します。
- 送信が完了していないメールの場合、`sendDateTime`、`recipients[].sendResultCode`、`recipients[].sendResultMessage`は`null`です。

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

レスポンスステータスコードの説明は次の通りです。

| HTTPステータスコード | コード | メッセージ | 説明 |
| --- | --- | --- | --- |
| 200 | - | OK | リクエスト成功 |
| 400 | InvalidParameter | Bad Request | リクエストパラメータエラー |
| 401 | Unauthorized | Unauthorized | 認証失敗 |
| 403 | Forbidden | Forbidden | パス内の`serviceId`に対する権限なし |
| 404 | NotFound | Not Found | パス内の`requestId`または`mailId`が存在しない |
| 500 | InternalServerError | Internal Server Error | サーバ内部エラー |

              参考

              

Simple & Easy Notification Serviceの他の APIと異なり、メール v2 APIは NAVERクラウドプラットフォーム API標準エラー形式でエラーを返します。レスポンスボディの`status`、`error`(文字列)フィールドではなく、以下の`error`オブジェクトが返されます。

#### エラーレスポンスボディ

呼び出しが失敗した場合のレスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `error` | Object | - | エラー情報 |
| `error.errorCode` | String | - | エラーコード - レスポンスステータスコード表のコード列を参照 |
| `error.message` | String | - | エラーコードごとの固定メッセージ - `x-ncp-lang`ヘッダに指定した言語で返す |
| `error.detail` | String | - | リクエストごとの詳細理由 - 該当する理由がない場合はフィールドが省略される |
| `error.fieldErrors` | Array | - | パラメータ別エラーリスト - `field`: エラーが発生したパラメータの名前 - `message`: エラーの理由 - パラメータエラーでない場合はフィールドは省略される |

#### エラーレスポンス例

呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。

```
{
"error": {
"errorCode": "NotFound",
"message": "The requested resource was not found."
}
}
```

### レスポンス例

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

```
{
"requestId": "20260712-R-01K0ZQ8YV3M4N5P6R7S8T9VAWX-777",
"mailId": "20260712-M-01K0ZQ8YVBQ7C2D3E4F5G6H7J8-777",
"requesterIp": "203.0.113.42",
"createDateTime": "2026-07-12T15:19:53+09:00",
"title": "ホンギルドン様、こんにちは。",
"templateNo": 41,
"templateName": "ランク変更のご案内",
"status": "PARTIAL_FAILED",
"senderAddress": "no_reply@company.com",
"senderName": "サポートセンター",
"sendDateTime": "2026-07-12T15:19:53+09:00",
"reservationDateTime": null,
"body": "<body>お客様のランクが SILVERから GOLDに変更されました。</body>",
"advertising": false,
"attachFiles": [
{
"fileId": "8f14e45fceea167a5a36dedd4bea2543",
"fileName": "ランクのご案内.pdf",
"fileSize": 204800
}
],
"recipients": [
{
"address": "hongildong@example.com",
"name": "ホンギルドン",
"type": "TO",
"received": false,
"receivedDateTime": null,
"status": "COMPLETED",
"retryCount": 0,
"sendResultCode": "MAIL_SENT",
"sendResultMessage": "Mail sent."
},
{
"address": "test12@example.com",
"name": null,
"type": "CC",
"received": false,
"receivedDateTime": null,
"status": "FAILED",
"retryCount": 0,
"sendResultCode": "RECIPIENT_ADDRESS_ERROR",
"sendResultMessage": "550 5.1.1 No such user - nsmtp"
}
]
}
```