GET
/v1/messages/{id}
Liefert den zuletzt bekannten Zustand einer Mail und ihren Verlauf aus den Postmark-Ereignissen: pending → accepted → delivered, oder bounced / complained; suppressed, invalid, failed, unknown, wenn Postmark nicht angenommen hat. Nur eigene Mails — eine fremde ID existiert für diesen Kunden nicht (404). Scope reporting.
Path-Parameter
| Name | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | string (UUID) | erforderlich | Die message_id aus der Antwort des Versands. z. B. 128e7694-9f93-41e3-88f8-d0c3083d6d63 |
Request · Next.js
const id = "128e7694-9f93-41e3-88f8-d0c3083d6d63";
const res = await fetch(`https://api.newsletterkit.ventureon.io/v1/messages/${id}`, {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.NEWSLETTERKIT_API_KEY}`,
},
});
const data = await res.json();Response 200
{
"data": {
"id": "128e7694-…",
"kind": "transactional",
"mode": "live",
"status": "delivered",
"template_id": "00000000-0000-4000-8000-0000000000f3",
"send_job_id": null,
"subject": "Dein Zugang zum Dashboard",
"bounce_type": null,
"error": null,
"created_at": "2026-09-03T15:20:11Z",
"delivered_at": "2026-09-03T15:20:14Z",
"first_opened_at": null,
"first_clicked_at": null,
"bounced_at": null,
"complained_at": null,
"events": [
{ "type": "delivery", "at": "2026-09-03T15:20:14Z", "details": { "details": "smtp;250 2.0.0 OK" } }
]
},
"request_id": "…"
}Verlauf 90 Tage, Zustand dauerhaft. Öffnungen und Klicks gibt es nur bei Newslettern — transaktionale Mails messen nichts. Die Zuordnung läuft über unsere Mail-ID, die als Postmark-Metadatum mitreist.