Skip to main content
GET
/
api
/
v1
/
emails
/
{id}
Get Email
curl --request GET \
  --url https://api.example.com/api/v1/emails/{id}
{
  "id": "<string>",
  "from": "<string>",
  "to": [
    "<string>"
  ],
  "cc": [
    "<string>"
  ],
  "bcc": [
    "<string>"
  ],
  "subject": "<string>",
  "status": "<string>",
  "messageId": "<string>",
  "templateId": "<string>",
  "createdAt": "<string>",
  "sentAt": "<string>",
  "deliveredAt": "<string>",
  "openedAt": "<string>",
  "clickedAt": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.mailbreeze.com/llms.txt

Use this file to discover all available pages before exploring further.

Get detailed information about a specific sent email by its ID.

​
Path Parameters

​
id
string
required
The unique email ID (e.g., msg_abc123).

​
Examples

import { MailBreeze } from "mailbreeze";

const mailbreeze = new MailBreeze({ apiKey: "sk_live_xxx" });

const email = await mailbreeze.emails.get("msg_abc123");

console.log(email.status);      // "delivered"
console.log(email.subject);     // "Welcome!"
console.log(email.deliveredAt); // "2024-01-15T10:30:05Z"

​
Response

​
id
string
Unique email ID.
​
from
string
Sender email address.
​
to
string[]
Recipient email addresses.
​
cc
string[]
CC recipients.
​
bcc
string[]
BCC recipients.
​
subject
string
Email subject line.
​
status
string
Current status: queued, sent, delivered, bounced, or failed.
​
messageId
string
SMTP message ID.
​
templateId
string
Template ID if sent with a template.
​
createdAt
string
ISO 8601 timestamp when created.
​
sentAt
string
ISO 8601 timestamp when sent.
​
deliveredAt
string
ISO 8601 timestamp when delivered.
​
openedAt
string
ISO 8601 timestamp when first opened (if tracking enabled).
​
clickedAt
string
ISO 8601 timestamp when first clicked (if tracking enabled).
Example Response
{
  "success": true,
  "data": {
    "email": {
      "id": "msg_abc123",
      "from": "hello@yourdomain.com",
      "to": ["user@example.com"],
      "subject": "Welcome!",
      "status": "delivered",
      "messageId": "abc123@mailbreeze.com",
      "templateId": "welcome-template",
      "createdAt": "2024-01-15T10:30:00Z",
      "sentAt": "2024-01-15T10:30:01Z",
      "deliveredAt": "2024-01-15T10:30:05Z",
      "openedAt": "2024-01-15T11:45:00Z",
      "clickedAt": null
    }
  },
  "meta": {
    "timestamp": "2024-01-15T10:30:00.000Z",
    "requestId": "req_abc123",
    "path": "/api/v1/emails/msg_abc123"
  }
}

​
Errors

CodeHTTP StatusDescription
NOT_FOUND404Email with this ID doesn’t exist