SDK / API ReferenceMessages
Get Message
GET /v0/messages/:messageId
Scope: mail:read
Get a specific email by its messageId.
Request
import { Loomal } from "@loomal/sdk";
const loomal = new Loomal({ apiKey: process.env.LOOMAL_API_KEY! });
const message = await loomal.mail.getMessage("<abc123@gmail.com>");import os
from loomal import Loomal
loomal = Loomal(api_key=os.environ["LOOMAL_API_KEY"])
message = loomal.mail.get_message("<abc123@gmail.com>")loomal mail get '<abc123@gmail.com>'Quote the messageId — it contains <>@ characters your shell will otherwise interpret.
mail.get_message(message_id)Available through @loomal/mcp — see MCP setup.
curl https://api.loomal.ai/v0/messages/%3Cabc123%40gmail.com%3E \
-H "Authorization: Bearer loid-your-api-key"URL-encode the messageId for REST calls.
Response — 200 OK
{
"messageId": "<abc123@gmail.com>",
"threadId": "thd_f8e2a1c4d7b90e3f",
"inboxId": "agent-x8k2m@mailgent.dev",
"from": ["customer@gmail.com"],
"to": ["agent-x8k2m@mailgent.dev"],
"cc": [],
"subject": "Question about pricing",
"text": "Hi, I'd like to know about your enterprise plan.\n\nBest,\nJohn",
"extractedText": "Hi, I'd like to know about your enterprise plan.",
"labels": ["received", "unread"],
"createdAt": "2026-03-28T12:00:00.000Z"
}404 Not Found
Returned when the messageId doesn't exist or belongs to a different identity.
{
"error": "not_found",
"message": "Message not found",
"status": 404
}