Skip to content

List inbound emails ​

Every message your domains received, newest first.

http
GET /v1/inbound-emails

Requires 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 ​

Cursor-paginated:

ParameterDefaultNotes
limit201–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": []
    }
  ]
}

Transactional email on your own domain.