---
title: "getMail"
slug: "ai-application-service-cloudoutboundmailer-getmail"
updated: 2026-09-17T09:57:24Z
published: 2026-09-17T09:57:24Z
canonical: "api.ncloud-docs.com/ai-application-service-cloudoutboundmailer-getmail"
---

> ## 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.

# getMail

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

送信リクエストしたメールリストを照会します。

## リクエスト

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

| メソッド | URI |
| --- | --- |
| GET | /mails/{mailId} |

### リクエストヘッダ

Cloud Outbound Mailer APIで共通して使用されるヘッダの詳細は、[Cloud Outbound Mailerのリクエストヘッダ](/docs/ja/ai-application-service-cloudoutboundmailer#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

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

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `mailId` | String | Required | メール識別用の固有 ID |

### リクエスト例

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

```
curl --location --request GET 'https://mail.apigw.ntruss.com/api/v1/mails/20181120000000010999' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
```

## レスポンス

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

### レスポンスボディ

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `requestId` | String | - | リクエスト識別のためのメール送信リクエスト ID - 一度に複数件のメール送信をリクエストする場合、`requestId`は複数の`mailId`を含むことができる |
| `requesterIp` | String | - | メール送信リクエスタ IPアドレス |
| `requestDate` | Object | - | リクエスト日時 - [NesDateTime](/docs/ja/common-vapidatatype-nesdatetime)を参照 |
| `mailId` | String | - | メール識別用の固有 ID |
| `title` | String | - | メールの件名 |
| `templateSid` | Integer | - | 照会したテンプレートの SID |
| `templateName` | String | - | 照会したテンプレートの名前 |
| `emailStatus` | Object | - | 送信状態 - [EmailStatus](/docs/ja/common-vapidatatype-nesstatus)を参照 |
| `senderAddress` | String | - | 送信者のメールアドレス |
| `senderName` | String | - | 送信者名 |
| `sendDate` | Object | - | 送信完了日時 - [NesDateTime](/docs/ja/common-vapidatatype-nesdatetime)を参照 |
| `reservationDate` | Object | - | 予約日時 - [NesDateTime](/docs/ja/common-vapidatatype-nesdatetime)を参照 |
| `body` | String | - | メールの本文 |
| `referencesHeader` | String | - | Referencesヘッダ - 0~100個で、<unique_id@domain.com>形式の文字列 - 特定のメールをまとめて見るための固有の値 - フィールドに値を入力すると、その後に同じ値が入力されたメールだけまとめて照会可能 - NAVERメールではメールをまとめて見るために使用 - 値が重複する場合、同じメールスレッドと判断してメールをまとめて表示 - Referencesヘッダの最上位値だけで判断 |
| `attachFiles` | List | - | 添付ファイルリスト - [AttachFile](/docs/ja/common-vapidatatype-nesattachfile)を参照 |
| `recipients` | List | - | 受信者リスト - [Recipient](/docs/ja/common-vapidatatype-nesrecipient)を参照 |
| `advertising` | Boolean | - | 広告メールかどうか - `true` \| `false` - `true`: 広告メール - `false`: 一般メール |

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

Cloud Outbound Mailer APIで共通して使用されるレスポンスステータスコードの詳細は、[Cloud Outbound Mailerのレスポンスステータスコード](/docs/ja/ai-application-service-cloudoutboundmailer#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

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

```
{
  "requestId":"20181120000000010999",
  "requesterIp":"10.78.xx.73",
  "requestDate":{
    "utc":1542694793240,
    "formattedDate":"2018-11-20",
    "formattedDateTime":"2018-11-20 15:19:53 240"
  },
  "mailId":"20181120000000011009",
  "title":"test!",
  "templateSid":41,
  "templateName":"test2",
  "emailStatus":{
    "label":"一部失敗",
    "code":"PF"
  },
  "senderAddress":"a@ac.om",
  "senderName":null,
  "sendDate":{
    "utc":1542694793856,
    "formattedDate":"2018-11-20",
    "formattedDateTime":"2018-11-20 15:19:53 856"
  },
  "reservationDate":null,
  "body":"<body>...</body>",
  "referencesHeader":null,
  "attachFiles":[

  ],
  "recipients":[
     {
      "address":"test123456789@ncp-mail.com",
      "name":"",
      "type":{
        "label":"受信者",
        "code":"R"
      },
      "received":false,
      "receivedDate":null,
      "status":{
        "label":"送信失敗",
        "code":"F"
      },
      "retryCount":0,
      "sendResultMessage":"550 5.1.1 No such user 3vir-yOYtA9fRTlWpjkR3 - nsmtp\n",
      "sendResultCode":"RECIPIENT_ADDRESS_ERROR",
      "sendResultCodeMessage":"受信者アドレスエラーにより、送信できません。"
    },
    {
      "address":"test12@ncp-mail.com",
      "name":"",
      "type":{
        "label":"受信者",
        "code":"R"
      },
      "received":false,
      "receivedDate":null,
      "status":{
        "label":"送信成功",
        "code":"S"
      },
      "retryCount":0,
      "sendResultMessage":"Mail sent.",
      "sendResultCode":"MAIL_SENT",
      "sendResultCodeMessage":"メールを送信しました。"
    }
  ],
  "advertising":false
}
```