{"uid":"cap_wDlYqgg5PCsNXoXg-MSC9","slug":"palmyr-communications-read-inbox-messages-18d45130","name":"Palmyr Communications - Read Inbox Messages","description":"Read decrypted messages from an inbox you own. Payment wallet must match the inbox wallet.","url":"https://palmyr.ai/email/inboxes/:id/messages","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"properties":{"queryParams":{"type":"object","additionalProperties":true}}},"output":{"properties":{"example":{"type":"object","additionalProperties":true}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_q5HPNkwBLqK3s2F9WU-8T","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves decrypted messages from a specific email inbox you own, authenticated by matching payment wallet.","exampleAgentPrompt":"Pull all the decrypted messages from my Palmyr inbox ID inbox_abc123 — I want to read what's arrived there.","exampleUseCases":null,"resultDescription":"A list of decrypted messages from the specified inbox, including message contents and metadata. Access is granted only when the paying wallet matches the inbox owner wallet.","failureModes":["Wallet address does not match inbox owner — returns 401/403 unauthorized","Inbox ID not found — returns 404","No messages in inbox — returns empty list","Payment failure or insufficient USDC balance — returns 402","Inbox ID malformed or invalid — returns 400"],"whenToPreferThis":"Use this endpoint when you need to programmatically read the contents of a Palmyr-hosted email inbox you own, especially in autonomous agent workflows that pay per call with USDC via x402. Prefer this over SMS endpoints when the communication channel is email rather than SMS.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:45:16.956Z","isFirstParty":false}