{"uid":"cap_2vx8ePYgcucBmEN2rKNJf","slug":"mermail-get-thread-emails-acb4ed2f","name":"Mermail Get Thread Emails","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/threads/%7BthreadId%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":["emails","totalCount"],"properties":{"emails":{"type":"array","items":{"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}},"totalCount":{"type":"integer","minimum":0}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"emails":[{"id":"email_1","date":"2026-09-20T00:00:00.000Z","sender":"noreply@example.com","subject":"Verification code","recipient":"agent@mermail.app","scan_status":"clean"}],"totalCount":1}},"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_6fs8R6fMW4DVzT0Nsf-Qx","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 all emails within a specific thread in an AI agent's Mermail mailbox","exampleAgentPrompt":"Pull up all the emails in thread thread_abc123 from my Mermail mailbox mailbox_xyz456 so I can review the full conversation.","exampleUseCases":[{"title":"Customer support thread review","prompt":"Show me all the emails in thread thread_support_789 from my Mermail mailbox mailbox_cs_001 — I need to see the full back-and-forth before responding to the customer."},{"title":"Sales lead nurture follow-up","prompt":"Fetch the conversation thread thread_lead_456 from my agent's Mermail mailbox mailbox_sales_002 so I can see where we left off with this prospect."},{"title":"Order confirmation thread check","prompt":"Get me all the emails in thread thread_order_321 from mailbox mailbox_shop_003 — I need to confirm whether the purchase verification came through."}],"resultDescription":"Returns a JSON object containing an array of email objects within the specified thread, each including id, subject, sender, recipient, date, body, read status, snippet, thread_id, scan_status, and content_omitted flag, along with a totalCount integer indicating the total number of emails in the thread.","failureModes":["Invalid mailboxId or threadId returns a 404 not found error","Unauthorized access returns a 401 or 403 if credentials are missing or incorrect","Empty thread returns emails array with zero items and totalCount of 0","Malformed query parameters may result in a 400 bad request","Network timeout or service unavailability returns a 503 or 5xx error"],"whenToPreferThis":"Use this endpoint when you need to read all messages within a specific, already-known email thread in a Mermail AI agent mailbox, as opposed to listing all threads or sending new messages. It is ideal for retrieving context before replying to a customer, reviewing a sales lead conversation, or verifying an order-related thread.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:50:20.737Z","isFirstParty":false,"canonicalSlug":"mermail-get-thread-emails-acb4ed2f"}