{"uid":"cap_8hH42IVlD4X5XJdTUBF9O","slug":"agentmail-list-pod-messages-by-direction-and-type-f0cc6973","name":"AgentMail List Pod Messages by Direction and Type","description":"AgentMail gives AI agents real email inboxes. Create, send, receive, and search messages via REST API — built for autonomous agents and agentic workflows.","url":"https://x402.api.agentmail.to/v0/pods/%7Bpod_id%7D/lists/%7Bdirection%7D/%7Btype%7D","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","pathParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","required":["pod_id","direction","type"],"properties":{"type":{"type":"string"},"pod_id":{"type":"string"},"direction":{"type":"string"}},"additionalProperties":false},"queryParams":{"type":"object","properties":{},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","additionalProperties":true}},"additionalProperties":false}},"additionalProperties":false},"responseSchema":{"type":"json","example":{}},"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_vlCsEmkIHpiZGotY8wZqf","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 email messages in a pod filtered by direction (inbox/sent) and type, returning a paginated collection of messages.","exampleAgentPrompt":"Show me all the received messages in my AgentMail pod 'agent-pod-123' — I want to see the full inbox list.","exampleUseCases":null,"resultDescription":"Returns a JSON collection of email messages belonging to the specified pod, filtered by direction (e.g. inbound/outbound) and message type. Each item typically includes message metadata such as sender, recipient, subject, timestamp, and message ID.","failureModes":["Invalid pod_id returns 404 not found","Invalid direction or type values return 400 bad request","Unauthorized access returns 401 if payment or auth is missing","Empty result set returns 200 with empty array if no messages match","Pod does not exist returns 404","Payment not provided returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when an AI agent needs to enumerate and browse messages within a specific pod, filtered by whether they are incoming or outgoing and by message type. Prefer this over general inbox listing when you have a specific pod ID and want directional filtering.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:46:29.415Z","isFirstParty":false}