API Reference

Retrieve an email

GET /emails/:id — fetch an email object and its event log.

GET/emails/:id

Retrieve a single email by id, including its current status and the ordered events array. Only emails belonging to your account are returned.

Path parameters

idstringrequired

The email id returned when the email was created.

Response fields

objectstringoptional

Always email.

idstringoptional

The email id.

message_idstringoptional

The RFC 5322 Message-ID assigned to the message, e.g. <111-222-333@email.example.com>.

fromstringoptional

The sender address the email was sent from.

tostring[]optional

The recipient addresses.

ccstring[]optional

Carbon-copy addresses (empty array if none).

bccstring[]optional

Blind carbon-copy addresses (empty array if none).

reply_tostring[]optional

Reply-To addresses (empty array if none).

subjectstringoptional

The subject line.

htmlstringoptional

The HTML body that was sent (may be null).

textstringoptional

The plain-text body that was sent (may be null).

statusstringoptional

Current status — see Managing emails.

last_eventstringoptional

The most recent recorded event type (falls back to status).

scheduled_atstringoptional

The scheduled send time, or null if the email was not scheduled.

created_atstringoptional

ISO 8601 creation timestamp.

tagsobject[]optional

The tags set on the email, each { name, value }.

eventsobject[]optional

Ordered event log: each entry is { type, created_at }.

Request

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.emails.get('49a3999c-0ce1-4ea6-ab68-afcd6dc2e794');
console.log({ data, error });

Response

The email object plus an events array. cc, bcc, reply_to, and tags are always present (empty array [] when nothing was set). text and html are present when the original send included them, null otherwise.

{
  "object": "email",
  "id": "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794",
  "message_id": "<111-222-333@email.example.com>",
  "from": "Acme <hello@yourdomain.com>",
  "to": ["delivered@example.com"],
  "cc": [],
  "bcc": [],
  "reply_to": [],
  "subject": "Hello from MailBlastr",
  "html": "<p>It works!</p>",
  "text": null,
  "status": "delivered",
  "last_event": "delivered",
  "scheduled_at": null,
  "created_at": "2026-06-23T10:00:00.000Z",
  "tags": [{ "name": "category", "value": "confirm_email" }],
  "events": [
    { "type": "sent", "created_at": "2026-06-23T10:00:00.000Z" },
    { "type": "delivered", "created_at": "2026-06-23T10:00:04.512Z" }
  ]
}

Errors

Returns not_found (404) if no email with that id exists for your account. See the error reference.