Get an inbound message

Fetch one inbound message by id — the same object the list returns and the forward action posts to your endpoint.

Retrieves a single stored inbound message. The shape is the `InboundMessage` object: lower-cased headers, bodies (truncated at 1 MB), attachment metadata and the SPF / DKIM / DMARC verdicts.

GET /v3/inbound/messages/{id}

Requires a full_access or read_only key — a send_only key is denied. An id of another workspace, a message a route did not store (unless ?kept=all, which also returns forward-only messages), or one already purged after 30 days, answers 404 not_found.

Responses

Status	Description
`200`	OK. The inbound message.
`401`	Missing or invalid API key.
`403`	`insufficient_scope` — a `send_only` key cannot read inbound mail.
`404`	No such inbound message on your workspace.

Code examples

cURL

curl https://api.wemail.io/v3/inbound/messages/6f1c2a1e-7d3b-4b7e-9f0e-2a4c8d9b1e55 \
  -H "Authorization: Bearer afn_live_…"

Node.js

const res = await fetch("https://api.wemail.io/v3/inbound/messages/6f1c2a1e-7d3b-4b7e-9f0e-2a4c8d9b1e55", {
  headers: { Authorization: `Bearer ${process.env.WEMAIL_API_KEY}` },
});
const message = await res.json();
console.log(message.auth, message.attachments);

Python

import os, requests

r = requests.get(
    "https://api.wemail.io/v3/inbound/messages/6f1c2a1e-7d3b-4b7e-9f0e-2a4c8d9b1e55",
    headers={"Authorization": f"Bearer {os.environ['WEMAIL_API_KEY']}"},
)
message = r.json()
print(message["auth"], message["attachments"])

client, _ := wemail.NewClient(os.Getenv("WEMAIL_API_KEY"))
ctx := context.WithValue(context.Background(), wemail.ContextAccessToken, os.Getenv("WEMAIL_API_KEY"))
message, _, err := client.API.InboundAPI.GetInboundMessage(ctx, "6f1c2a1e-7d3b-4b7e-9f0e-2a4c8d9b1e55").Execute()

ResponseExample response

{
  "id": "6f1c2a1e-7d3b-4b7e-9f0e-2a4c8d9b1e55",
  "domain": "leads.example.com",
  "route_id": "0b7e4c2d-9a1f-4e6b-8c3d-5f2a1b9e7d40",
  "message_id": "CAF3k9Qx7Z@mail.gmail.com",
  "from": "Maria Papadopoulou <maria@efood.gr>",
  "to": "kostas@leads.example.com",
  "envelope_to": ["kostas@leads.example.com"],
  "cc": [],
  "subject": "Re: Quick question about your ESP",
  "text": "Hi Kostas, yes — let's talk next week.",
  "html": null,
  "text_truncated": false,
  "html_truncated": false,
  "headers": {
    "message-id": "<CAF3k9Qx7Z@mail.gmail.com>",
    "in-reply-to": "<msg_01HBYE7K9Z4PMQDR3W@leads.example.com>",
    "references": "<msg_01HBYE7K9Z4PMQDR3W@leads.example.com>",
    "date": "Mon, 3 Nov 2026 10:14:19 +0200",
    "subject": "Re: Quick question about your ESP"
  },
  "attachments": [],
  "auth": { "spf": "pass", "dkim": "pass", "dmarc": "pass" },
  "size_bytes": 4120,
  "received_at": "2026-11-03T08:14:21.417Z",
  "created_at": "2026-11-03T08:14:21.603Z"
}