Back to Browse
Mermail Email Retrieval - Get Single Email by ID
x402
Mermail Email Retrieval - Get Single Email by ID is a paid API for AI agents from console.mermail.app, paid per call via x402, price unknown, status unknown (last checked 2026-10-11).
Retrieves a single email message from an AI agent's Mermail mailbox by mailbox ID and email ID, returning metadata and content.
Price / call—
Success—
StatusUnknown
How this service works
An inbox and wallet for your AI agent. Find and nurture sales leads, resolve customer support, and handle online purchases with controlled payments.
Output
Returns a JSON object containing the email's ID, subject, sender address, recipient address, date/time received, body text, snippet, read status, thread ID, scan status (clean/flagged/skipped/null), and a flag indicating whether content was omitted due to scanning or policy.
Example use cases
Retrieve verification code email
“My agent just received a verification code email in its Mermail inbox — can you fetch the email with ID email_42 from mailbox mb_001 and read out the verification code from the body?”
Check scan status of suspicious message
“There's an email in my agent's Mermail inbox with ID email_99 — can you retrieve it and tell me whether the scanner flagged it as clean or suspicious?”
Read customer support reply
“A customer replied to my agent's support message. Fetch email email_77 from mailbox mb_support so I can see exactly what they said and figure out how to respond.”
Technical details
Endpoint
GEThttps://console.mermail.app/api/agent/v1/mailboxes/%7BmailboxId%7D/emails/%7BemailId%7D?utm_source=zero.xyzWhen to prefer
Use this endpoint when you already know the specific email ID and mailbox ID and need to retrieve the full details or body of a single email from a Mermail agent inbox. Prefer this over list endpoints when you have a targeted email reference (e.g. from a prior list or webhook notification) and need complete message data including body and scan status.
Side effects
- Invalid or non-existent mailboxId returns 404 Not Found
- Invalid or non-existent emailId within the mailbox returns 404 Not Found
- Unauthorized access (missing or invalid payment/auth headers) returns 402 Payment Required or 401
- Email content omitted if scan_status is flagged or content_omitted is true
- Malformed request parameters return 400 Bad Request
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"type": "json",
"example": {
"id": "email_1",
"date": "2026-09-20T00:00:00.000Z",
"sender": "noreply@example.com",
"subject": "Verification code",
"recipient": "agent@mermail.app",
"scan_status": "clean"
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"