curl -X GET "https://api.wirebox.sh/api/v1/mailboxes/eva/threads" \
-H "Authorization: Bearer $WIREBOX_API_KEY"
{
"threads": [
{
"id": "thrd_01J8XYZ987ABC",
"mailbox_id": "mbx_01J8ABC123XYZ",
"subject": "Question regarding my API quota",
"snippet": "Hi Eva, how can I increase my monthly quota?",
"folder": "inbox",
"message_count": 2,
"has_attachments": false,
"is_unread": false,
"last_message_at": "2026-09-11T12:05:00Z",
"created_at": "2026-09-11T12:00:00Z"
}
],
"next_cursor": null,
"has_more": false
}
Mail
List Conversation Threads
List and retrieve RFC-grouped conversation threads for an agent mailbox.
GET
/
api
/
v1
/
mailboxes
/
{email_address}
/
threads
curl -X GET "https://api.wirebox.sh/api/v1/mailboxes/eva/threads" \
-H "Authorization: Bearer $WIREBOX_API_KEY"
{
"threads": [
{
"id": "thrd_01J8XYZ987ABC",
"mailbox_id": "mbx_01J8ABC123XYZ",
"subject": "Question regarding my API quota",
"snippet": "Hi Eva, how can I increase my monthly quota?",
"folder": "inbox",
"message_count": 2,
"has_attachments": false,
"is_unread": false,
"last_message_at": "2026-09-11T12:05:00Z",
"created_at": "2026-09-11T12:00:00Z"
}
],
"next_cursor": null,
"has_more": false
}
Path Parameters
string
required
Full mailbox address (
eva@wireboxmail.com) or local agent handle (eva).Query Parameters
integer
default:"50"
Number of threads to return (1–100).
Response
string
Unique thread identifier (
thrd_ prefix).string
Mailbox this thread belongs to.
string
Thread subject.
string
Short preview of the latest message.
string
Folder the thread currently lives in (e.g.
inbox).integer
Number of messages in the thread.
boolean
Whether any message in the thread has attachments.
boolean
Whether the thread has unread messages.
string
ISO 8601 timestamp of the most recent message.
string
ISO 8601 creation timestamp.
curl -X GET "https://api.wirebox.sh/api/v1/mailboxes/eva/threads" \
-H "Authorization: Bearer $WIREBOX_API_KEY"
{
"threads": [
{
"id": "thrd_01J8XYZ987ABC",
"mailbox_id": "mbx_01J8ABC123XYZ",
"subject": "Question regarding my API quota",
"snippet": "Hi Eva, how can I increase my monthly quota?",
"folder": "inbox",
"message_count": 2,
"has_attachments": false,
"is_unread": false,
"last_message_at": "2026-09-11T12:05:00Z",
"created_at": "2026-09-11T12:00:00Z"
}
],
"next_cursor": null,
"has_more": false
}
Retrieve a Thread
Returns a single thread with all of its messages inlined in chronological order.Path Parameters
string
required
Unique thread identifier (
thrd_ prefix).curl -X GET "https://api.wirebox.sh/api/v1/mailboxes/eva/threads/thrd_01J8XYZ987ABC" \
-H "Authorization: Bearer $WIREBOX_API_KEY"
Response
string
Unique message identifier.
string
inbound or outbound.string
Delivery status (
queued, sent, delivered, bounced, or failed).string
Sender email address.
string[]
Recipient email addresses.
string[]
CC recipient email addresses.
string
Message subject.
string
Plain-text body.
string
HTML body.
boolean
Whether the message has been read.
boolean
Whether the message has attachments.
string
ISO 8601 creation timestamp.
{
"id": "thrd_01J8XYZ987ABC",
"mailbox_id": "mbx_01J8ABC123XYZ",
"subject": "Question regarding my API quota",
"snippet": "Thanks, that answers it!",
"folder": "inbox",
"message_count": 2,
"has_attachments": false,
"is_unread": false,
"last_message_at": "2026-09-11T12:05:00Z",
"created_at": "2026-09-11T12:00:00Z",
"messages": [
{
"id": "msg_01J8ABC123XYZ",
"direction": "inbound",
"status": "received",
"from": "alex@example.com",
"to": ["eva@wireboxmail.com"],
"cc": [],
"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>",
"is_read": true,
"has_attachments": false,
"created_at": "2026-09-11T12:00:00Z"
}
]
}