Appearance
List inbound emails
Every message your domains received, newest first.
http
GET /v1/inbound-emailsRequires a Full access API key. A Sending key gets 403 restricted_api_key.
Only mail that arrived is listed — replies and messages sent from the inbox are outbound email.
Parameters
| Parameter | Default | Notes |
|---|---|---|
limit | 20 | 1–100. |
after | — | An inbound email id. Returns the ones after it (older). |
before | — | An inbound email id. Returns the ones before it (newer). |
Example
bash
curl "https://api.sendgrail.com/v1/inbound-emails?limit=2" \
-H "Authorization: Bearer $SENDGRAIL_API_KEY"js
const res = await fetch('https://api.sendgrail.com/v1/inbound-emails?limit=2', {
headers: { Authorization: `Bearer ${process.env.SENDGRAIL_API_KEY}` },
});
const { data, has_more } = await res.json();Response
Each item is an inbound email object without text, html and headers — retrieve one for those.
json
{
"object": "list",
"has_more": true,
"data": [
{
"object": "inbound_email",
"id": "0f6d2a8e-3b1c-4c9a-9f2e-7a5d1b8c4e21",
"mailbox": "support@inbound.example.com",
"message_id": "CAF3xk2Q@mail.sender.example",
"thread_id": "6a1e9c30-2d4b-4f7e-8b5a-0c9d3e2f1a47",
"from": "alice@sender.example",
"from_name": "Alice",
"to": ["support@inbound.example.com"],
"cc": [],
"subject": "Invoice for March",
"received_at": "2026-09-16T08:41:12+00:00",
"spam_verdict": "PASS",
"virus_verdict": "PASS",
"attachments": []
}
]
}