{"uid":"cap_jZXfKyov5N8itmaNLlwkI","slug":"mermail-mailbox-details-lookup-80b7223a","name":"Mermail Mailbox Details Lookup","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?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","public_id","workspace_id","email","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string","format":"email"},"public_id":{"type":"string","format":"uuid"},"can_receive":{"type":"boolean"},"workspace_id":{"type":"string"},"receiving_status":{"enum":["ready","disabled","unavailable"],"type":"string"}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"id":"mailbox_1","name":"Support agent","email":"agent@mermail.app","public_id":"11111111-1111-4111-8111-111111111111","can_receive":true,"workspace_id":"workspace_1","receiving_status":"ready"}},"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_25fyQWfd0iVBot8H3JEre","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 details of a specific AI agent mailbox by its mailbox ID, including email address, name, receiving status, and workspace association.","exampleAgentPrompt":"Can you check the status of my Mermail mailbox with ID mailbox_1 and tell me if it's ready to receive messages and what email address it's using?","exampleUseCases":[{"title":"Verify agent inbox before campaign","prompt":"Before I kick off the sales outreach campaign, check if the Mermail mailbox mailbox_42 is in ready status and give me its email address so I can configure the sender routing."},{"title":"Support inbox health check","prompt":"Can you pull up the details for Mermail mailbox mailbox_support_01 — I need to know if can_receive is true and what the current receiving_status is before I go live with customer support."},{"title":"Fetch mailbox identity for agent handoff","prompt":"I'm setting up a new agent handoff and need the public UUID and workspace ID for Mermail mailbox mailbox_7 — can you fetch that for me?"}],"resultDescription":"Returns a JSON object containing the mailbox's internal ID, human-readable name, assigned email address, public UUID, workspace ID, a boolean indicating whether it can receive mail, and an enum receiving_status of 'ready', 'disabled', or 'unavailable'.","failureModes":["Mailbox ID not found — returns 404 or empty response","Invalid or malformed mailboxId in URL path — returns 400","Unauthorized access if authentication headers are missing or invalid — returns 401","Mailbox belongs to a different workspace — returns 403","Service unavailable or Mermail platform down — returns 5xx"],"whenToPreferThis":"Use this endpoint when you need to verify the configuration, identity, or readiness of a specific Mermail agent mailbox before routing messages to it or when setting up agentic communication workflows. It is the authoritative source for mailbox status and email address for a given mailboxId.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:42:18.692Z","isFirstParty":false,"canonicalSlug":"mermail-mailbox-details-lookup-80b7223a"}