Email Logs API

直近30日間に送信したメールの送信状況やイベントの情報を取得できます。

Filter messages by ID [GET]

特定のメールのログを取得します。メールの指定に必要なsg_message_idパラメータの値は、Filter all messagesエンドポイントで取得できます。

URI引数 必須 条件 説明
sg_message_id Yes string 取得対象とするメールのメッセージID
（SendGrid Message ID）
subuser No string サブユーザのAccount ID
（サブユーザでログインするとAccount Details画面で確認できます。サブユーザ名ではありません。）
親アカウントのAPIキーでサブユーザの情報を取得する場合に指定

Request

1

GET https://api.sendgrid.com/v3/logs/{sg_message_id}?subuser={AccountID}  HTTP/1.1

Response

JSONパラメータ 型 制限 詳細
from_email string
送信元メールアドレス
sg_message_id string
メッセージID（SendGrid Message ID）
subject string
メールの件名
to_email string
宛先メールアドレス
status string processed,
delivered,
deferred,
dropped,
bounced,
blocked
のいずれか
メールの送信状況
template_id string
使用しているメールテンプレートのID
asm_group_id integer
使用している配信停止グループのID
api_key_id string
使用しているAPIキーのID
events オブジェクト配列 最大100件
各メッセージに関連するイベント情報（最新のイベントから最大100件）
client_ip string
メール送信をリクエストした環境のIPアドレス
category 配列
メールに関連付けたカテゴリ
custom_args オブジェクト
メールに関連付けたユニーク引数
outbound_ip string
メールの送信元IPアドレス
outbound_ip_type string dedicated,
shared
のいずれか
送信元IPアドレスの種類（固定IPアドレスまたは共有IPアドレス） 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

HTTP/1.1 200
{
    "from_email": "from@example.com",
    "sg_message_id": "aPGnN5Y3QkmACBpTM6xDRw.recvd-65696df74f-8tbhj-1-6941F75B-1D.0",
    "subject": "Hello, SendGrid!",
    "status": "delivered",
    "to_email": "to@example.com",
    "template_id": "d-327225f54b464b5bb1e864e78a6ea62f",
    "asm_group_id": 25775,
    "api_key_id": "AuIn2KBETT6BqwgswddGyg",
    "events": [
        {
            "event": "received",
            "recv_msgid": "aPGnN5Y3QkmACBpTM6xDRw",
            "sg_event_id": "cmVjZWl2ZWQtMjY5MjM0MTAtdmhiVnN0YjVUbXU5eV9NMDlRakpvdw",
            "timestamp": 1765930843,
            "api_key_id": "0zj7HXkzQbiH0pgO3dASkw",
            "api_version": "3",
            "client_ip": "54.86.50.139",
            "protocol": "HTTP",
            "recipient_count": 1,
            "reseller_id": "26923410",
            "size": 896,
            "useragent": "PostmanRuntime/7.51.0",
            "v3_payload_details": {
                "sender_count": 1,
                "substitution_bytes": 0,
                "substitution_count": 0,
                "content_bytes": 128,
                "customarg_largest_bytes": 29,
                "customarg_count": 1,
                "text/html": 1,
                "attachments_bytes": 0,
                "recipient_count": 1,
                "personalization_count": 1
            }
        },
        {
            "event": "processed",
            "email": "to@example.com",
            "sg_message_id": "aPGnN5Y3QkmACBpTM6xDRw.recvd-65696df74f-8tbhj-1-6941F75B-1D.0",
            "sg_event_id": "cHJvY2Vzc2VkLTI2OTIzNDEwLWFQR25ONVkzUWttQUNCcFRNNnhEUnctMA",
            "timestamp": 1765930844,
            "smtp-id": "<aPGnN5Y3QkmACBpTM6xDRw@geopod-ismtpd-32>",
            "category": [
                "greetings"
            ],
            "asm_group_id": 25775,
            "custom_args": {
                "custom_args_test": "A"
            }
        },
        {
            "event": "delivered",
            "email": "to@example.com",
            "sg_message_id": "aPGnN5Y3QkmACBpTM6xDRw.recvd-65696df74f-8tbhj-1-6941F75B-1D.0",
            "sg_event_id": "ZGVsaXZlcmVkLTAtMjY5MjM0MTAtYVBHbk41WTNRa21BQ0JwVE02eERSdy0w",
            "timestamp": 1765930846,
            "smtp-id": "<aPGnN5Y3QkmACBpTM6xDRw@geopod-ismtpd-32>",
            "ip": "168.245.38.183",
            "response": "250 2.0.0 OK  1765930846 af79cd13be357-8be31c837b6si416141385a.403 - gsmtp",
            "tls": 1,
            "category": [
                "greetings"
            ],
            "asm_group_id": 25775,
            "custom_args": {
                "custom_args_test": "A"
            }
        }
    ],
    "client_ip": "54.86.50.139",
    "category": [
        "greetings"
    ],
    "custom_args": {
        "custom_args_test": "A"
    },
    "outbound_ip": "168.245.38.183",
    "outbound_ip_type": "dedicated"
}

Filter all messages [POST]

検索条件を指定し、条件にあてはまるメールの一覧を取得します。
検索条件を指定しない場合は、リクエストボディに空のJSON（{}）を指定してください。

Request

1

POST https://api.sendgrid.com/v3/logs HTTP/1.1

Request Body

JSONパラメータ 型 制限 詳細
query string
検索条件を指定するクエリ
使用可能なクエリはこちら
limit integer 1~1,000
取得する結果の件数上限
Default：10
subusers 配列 1回の呼び出しにつき1つのみ
サブユーザのAccount ID
（サブユーザでログインするとAccount Details画面で確認できます。サブユーザ名ではありません。）
親アカウントのAPIキーでサブユーザの情報を取得する場合に指定		 
1
2
3
4
5

{
    "query":"sg_message_id_created_at > TIMESTAMP '2025-12-01T00:00:00Z' AND categories IN ('newsletter', 'marketing')",
    "limit":5,
    "subusers":["20223230"]
}

Response

JSONパラメータ 型 制限 詳細
messages オブジェクト配列
from_email string
送信元メールアドレス
sg_message_id string
メッセージID（SendGrid Message ID）
subject string
メールの件名
to_email string
宛先メールアドレス
reason string
イベントの原因に関する説明
status string processed,
delivered,
deferred,
dropped,
bounced,
blocked
のいずれか
メールの送信状況
sg_message_id_created_at string ISO 8601フォーマット（YYYY-MM-DDThh:mm:ss）
メッセージIDが作成された時刻 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

HTTP/1.1 200
{
    "messages": [
       {
            "from_email": "from@example.com",
            "sg_message_id": "aPGnN5Y3QkmACBpTM6xDRw.recvd-65696df74f-8tbhj-1-6941F75B-1D.0",
            "subject": "Hello, SendGrid!",
            "to_email": "to@example.com",
            "reason": "250 2.0.0 OK  1765930846 af79cd13be357-8be31c837b6si416141385a.403 - gsmtp",
            "status": "delivered",
            "sg_message_id_created_at": "2025-12-16T05:17:34Z"
        },
       {
            "from_email": "from@example.com",
            "sg_message_id": "U6pgnlm8SPOJxhd4NLOYEg.recvd-canary-6dcdfbf987-th9vq-1-697188D0-24.0",
            "subject": "Hello, SendGrid!",
            "to_email": "to@example.com",
            "250 2.0.0 OK  1769048273 d75a77b69052e-502a1d54563si188917631cf.93 - gsmtp",
            "status": "delivered",
            "sg_message_id_created_at": "2025-12-18T07:00:02Z"
        }
    ]
}

関連情報