curl -X GET "https://api.wirebox.sh/api/v1/mailboxes/eva/messages/msg_01J8ABC123XYZ" \
-H "Authorization: Bearer $WIREBOX_API_KEY"
from wirebox import Wirebox
with Wirebox() as wirebox:
eva = wirebox.get_identity("eva")
msg = eva.get_message("msg_01J8ABC123XYZ")
print(f"[{msg.from_address}] {msg.subject}")
print(msg.text)
import { Wirebox } from "@wirebox-sh/sdk";
const wirebox = new Wirebox();
const eva = await wirebox.getIdentity("eva");
const msg = await eva.getMessage("msg_01J8ABC123XYZ");
console.log(`[${msg.from}] ${msg.subject}`);
console.log(msg.text);
wirebox mail get msg_01J8ABC123XYZ --identity eva
{
"id": "msg_01J8ABC123XYZ",
"mailbox_id": "mbx_01J8ABC123XYZ",
"thread_id": "thrd_01J8XYZ987ABC",
"direction": "inbound",
"status": "received",
"from": "alex@example.com",
"to": ["eva@wireboxmail.com"],
"cc": [],
"bcc": [],
"subject": "Question regarding my API quota",
"text": "Hi Eva, how can I increase my monthly quota?",
"html": "<p>Hi Eva, how can I increase my monthly quota?</p>",
"in_reply_to_message_id": null,
"is_read": false,
"is_starred": false,
"attachments": [
{
"id": "att_01J8ABC123XYZ",
"filename": "quota-report.pdf",
"content_type": "application/pdf",
"size_bytes": 48213,
"content_id": null,
"url": "https://api.wirebox.sh/media/att_01J8ABC123XYZ?expires=1780000000&signature=..."
}
],
"created_at": "2026-09-11T12:00:00Z"
}
Mail
Get Message
Retrieve the full content of a single email message, including headers, bodies, and attachment links.
GET
/
api
/
v1
/
mailboxes
/
{email_address}
/
messages
/
{message_id}
curl -X GET "https://api.wirebox.sh/api/v1/mailboxes/eva/messages/msg_01J8ABC123XYZ" \
-H "Authorization: Bearer $WIREBOX_API_KEY"
from wirebox import Wirebox
with Wirebox() as wirebox:
eva = wirebox.get_identity("eva")
msg = eva.get_message("msg_01J8ABC123XYZ")
print(f"[{msg.from_address}] {msg.subject}")
print(msg.text)
import { Wirebox } from "@wirebox-sh/sdk";
const wirebox = new Wirebox();
const eva = await wirebox.getIdentity("eva");
const msg = await eva.getMessage("msg_01J8ABC123XYZ");
console.log(`[${msg.from}] ${msg.subject}`);
console.log(msg.text);
wirebox mail get msg_01J8ABC123XYZ --identity eva
{
"id": "msg_01J8ABC123XYZ",
"mailbox_id": "mbx_01J8ABC123XYZ",
"thread_id": "thrd_01J8XYZ987ABC",
"direction": "inbound",
"status": "received",
"from": "alex@example.com",
"to": ["eva@wireboxmail.com"],
"cc": [],
"bcc": [],
"subject": "Question regarding my API quota",
"text": "Hi Eva, how can I increase my monthly quota?",
"html": "<p>Hi Eva, how can I increase my monthly quota?</p>",
"in_reply_to_message_id": null,
"is_read": false,
"is_starred": false,
"attachments": [
{
"id": "att_01J8ABC123XYZ",
"filename": "quota-report.pdf",
"content_type": "application/pdf",
"size_bytes": 48213,
"content_id": null,
"url": "https://api.wirebox.sh/media/att_01J8ABC123XYZ?expires=1780000000&signature=..."
}
],
"created_at": "2026-09-11T12:00:00Z"
}
Path Parameters
string
required
Full mailbox address (
eva@wireboxmail.com) or local agent handle (eva).string
required
Unique message identifier (
msg_ prefix).Response
string
Unique message identifier.
string
Mailbox the message belongs to.
string
Conversation thread this message belongs to.
string
inbound or outbound.string
Message status:
received for admitted inbound mail, quarantined when held by inbound guardrails, or queued, sent, delivered, bounced, or failed for outbound mail.string
Sender address.
string[]
Recipient addresses.
string[]
CC recipient addresses.
string[]
BCC recipient addresses.
string
Subject line.
string
Plain-text body.
string
HTML body.
string | null
ID of the message this one replies to, when applicable.
boolean
Whether the message has been read.
boolean
Whether the message is starred.
object[]
Attachment metadata:
id, filename, content_type, size_bytes, content_id, and a freshly signed download url (or null for legacy rows whose bytes were never stored).string
ISO 8601 creation timestamp.
curl -X GET "https://api.wirebox.sh/api/v1/mailboxes/eva/messages/msg_01J8ABC123XYZ" \
-H "Authorization: Bearer $WIREBOX_API_KEY"
from wirebox import Wirebox
with Wirebox() as wirebox:
eva = wirebox.get_identity("eva")
msg = eva.get_message("msg_01J8ABC123XYZ")
print(f"[{msg.from_address}] {msg.subject}")
print(msg.text)
import { Wirebox } from "@wirebox-sh/sdk";
const wirebox = new Wirebox();
const eva = await wirebox.getIdentity("eva");
const msg = await eva.getMessage("msg_01J8ABC123XYZ");
console.log(`[${msg.from}] ${msg.subject}`);
console.log(msg.text);
wirebox mail get msg_01J8ABC123XYZ --identity eva
{
"id": "msg_01J8ABC123XYZ",
"mailbox_id": "mbx_01J8ABC123XYZ",
"thread_id": "thrd_01J8XYZ987ABC",
"direction": "inbound",
"status": "received",
"from": "alex@example.com",
"to": ["eva@wireboxmail.com"],
"cc": [],
"bcc": [],
"subject": "Question regarding my API quota",
"text": "Hi Eva, how can I increase my monthly quota?",
"html": "<p>Hi Eva, how can I increase my monthly quota?</p>",
"in_reply_to_message_id": null,
"is_read": false,
"is_starred": false,
"attachments": [
{
"id": "att_01J8ABC123XYZ",
"filename": "quota-report.pdf",
"content_type": "application/pdf",
"size_bytes": 48213,
"content_id": null,
"url": "https://api.wirebox.sh/media/att_01J8ABC123XYZ?expires=1780000000&signature=..."
}
],
"created_at": "2026-09-11T12:00:00Z"
}