/v1/workspaces/{workspace_id}/mailboxes/{id}/messagesAuthList messages in a mailbox
Path parameters
workspace_id*string · uuidId of the workspace.
id*string · uuidId of the mailboxe.
Query parameters
fromstringFilter by From address (substring match)
subjectstringFilter by subject (substring match)
sincestring · date-timeOnly include messages received on or after this ISO-8601 timestamp.
untilstring · date-timeOnly include messages received on or before this ISO-8601 timestamp.
unreadbooleanFilter to only unread (true) or only read (false) messages
limitintegerPage size, 1–100.
cursorstringOpaque pagination cursor
Response · 200
data*arrayThe messages on this page, newest first.
pagination*objectnext_cursor*stringOpaque cursor for the next page. `null` when no more pages are available.
Example: "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQwMDowMDowMFoifQ"
has_more*booleanTrue iff another page exists; if true, pass `next_cursor` on the next request.
Example: false
Example
Request
GET https://api.mail.productcraft.co/v1/workspaces/{workspace_id}/mailboxes/{id}/messages
Authorization: Bearer YOUR_TOKENimport { Mail } from "@productcraft/mail";
// Reads PRODUCTCRAFT_API_KEY from the environment
const mail = new Mail();
for await (const message of mail.mailboxes.messages.list("3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f")) {
console.log(message);
}
const page = await mail.mailboxes.messages.list("3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f", {}, { timeout: 5_000 });mail.mailboxes.messages.list(mailboxId, params?, options?): PagePromise<Mail.Message>
Response
{
"data": [
{
"id": "00000000-0000-0000-0000-000000000000",
"mailbox_id": "00000000-0000-0000-0000-000000000000",
"seq_id": "42",
"raw_object_key": "string",
"envelope_to": "string",
"from_address": "string",
"from_local": "string",
"from_domain": "string",
"to_addresses": [
"string"
],
"cc_addresses": [
"string"
],
"subject": "string",
"body_preview": "string",
"rfc822_message_id": "string",
"size_bytes": 0,
"spam_score": "string",
"spam_verdict": "string",
"spf_result": "string",
"dkim_result": "string",
"dmarc_result": "string",
"quarantined": false,
"received_at": "2026-01-01T00:00:00.000Z",
"read_at": "2026-01-01T00:00:00.000Z",
"deleted_at": "2026-01-01T00:00:00.000Z"
}
],
"pagination": {
"next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQwMDowMDowMFoifQ",
"has_more": false
}
}