{"uid":"cap_xt4Lpzf_5Gvz4-1AWOxef","slug":"mermail-mailbox-email-list-482858ad","name":"Mermail Mailbox Email List","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?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","properties":{"limit":{"type":"integer","maximum":100,"minimum":1},"cursor":{"type":"string"},"folder":{"type":"string"},"sortColumn":{"enum":["id","subject","sender","recipient","date","read","starred"],"type":"string"},"metadata_only":{"type":"boolean"},"sortDirection":{"enum":["ASC","DESC"],"type":"string"},"agent_safe_content":{"type":"boolean"},"require_scan_status":{"enum":["clean","flagged","skipped"],"type":"string"}},"additionalProperties":false}},"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":{"status":"queued"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","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":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1b9U9xcf171hR6-5hwAWG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Lists emails in an AI agent's Mermail mailbox with filtering, sorting, and safety scanning options","exampleAgentPrompt":"Check my Mermail inbox for the latest 20 emails in the support folder, sorted by date descending, and only show me ones that have been scanned as clean — just metadata, no body content.","exampleUseCases":[{"title":"Customer support triage for agents","prompt":"Pull the last 25 emails from my Mermail support folder, sorted newest first, and only include ones flagged as clean by the scanner so I can start responding to customers."},{"title":"Sales lead monitoring pipeline","prompt":"Check my Mermail inbox for new emails in the leads folder, show me up to 50 at a time sorted by date, and include full body content so I can qualify and respond to potential customers."},{"title":"Paginated inbox review with safety filter","prompt":"Fetch the next page of emails from my Mermail mailbox using cursor abc123, limit 10, and only return metadata without body text so I can quickly scan subjects and senders without exposing raw content to downstream tools."}],"resultDescription":"Returns a paginated list of emails with fields including id, subject, sender, recipient, date, body (if not metadata_only), snippet, thread_id, read status, scan_status, and content_omitted flag, along with a totalCount of matching emails.","failureModes":["Invalid or unknown mailboxId returns 404 or empty result","Invalid cursor value causes pagination error","Exceeding limit of 100 per page returns validation error","Requesting non-existent folder returns empty email list","Payment not processed (x402) results in 402 Payment Required before data is returned","Invalid enum value for sortColumn or sortDirection returns 400 error","Scan status filter with no matching emails returns empty list with totalCount 0"],"whenToPreferThis":"Use this endpoint when your AI agent needs to programmatically read, filter, and process incoming emails from a Mermail managed inbox — especially when you need safety scanning (clean/flagged/skipped), agent-safe content formatting, or metadata-only retrieval to protect downstream systems. Prefer this over general email APIs when you need built-in payment-gated access and agent-first design.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:38:16.007Z","isFirstParty":false,"canonicalSlug":"mermail-mailbox-email-list-482858ad"}