{"uid":"cap_D4jXOJMReejAs_FiDuuNJ","slug":"mermail-email-retrieval-get-single-email-by-id-c8f0f2e0","name":"Mermail Email Retrieval - Get Single Email by ID","description":"An inbox and wallet for your AI agent. Find and nurture sales leads, resolve customer support, and handle online purchases with controlled payments.","url":"https://console.mermail.app/api/agent/v1/mailboxes/%7BmailboxId%7D/emails/%7BemailId%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["id","subject","sender","recipient","date"],"properties":{"id":{"type":"string"},"body":{"type":"string"},"date":{"type":"string","format":"date-time"},"read":{"type":"boolean"},"sender":{"type":"string"},"snippet":{"type":"string"},"subject":{"type":"string"},"recipient":{"type":"string"},"thread_id":{"type":["string","null"]},"scan_status":{"enum":["clean","flagged","skipped",null],"type":["string","null"]},"content_omitted":{"type":"boolean"}},"additionalProperties":true}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_BDnvPVkCS6-VSBz9XcFJT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a single email message from an AI agent's Mermail mailbox by mailbox ID and email ID, returning metadata and content.","exampleAgentPrompt":"Pull up the email with ID email_1 from my Mermail mailbox so I can see who sent it, what the subject is, and read the full message body.","exampleUseCases":[{"title":"Retrieve verification code email","prompt":"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?"},{"title":"Check scan status of suspicious message","prompt":"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?"},{"title":"Read customer support reply","prompt":"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."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:48:48.384Z","isFirstParty":false,"canonicalSlug":"mermail-email-retrieval-get-single-email-by-id-c8f0f2e0"}