{"uid":"cap_sEdNbQY5-sTwl_0TjaeM9","slug":"agentmail-get-thread-de11a6a2","name":"AgentMail Get Thread","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/threads/%7Bthread_id%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","thread_id"],"properties":{"pod_id":{"type":"string"},"thread_id":{"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","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","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":"free","summary":"Free","primary":{"kind":"free","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_KnlYs4N5plBRfTFFHD-Jc","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":"Retrieve a specific email thread by ID from an AgentMail pod","exampleAgentPrompt":"Pull up the full email thread with thread ID 'thd_abc123' from my AgentMail pod 'pod_xyz456' so I can see all the messages in that conversation.","exampleUseCases":[{"title":"Monitor customer support conversations","prompt":"Check the latest messages in thread ID 'thd_support_ticket_001' from my support agent pod to see if the customer has replied to our solution yet."},{"title":"Review partnership negotiation emails","prompt":"Pull up the full thread with ID 'thd_partner_deal_042' from my business development pod so I can see where we left off in the negotiation and what terms were discussed."},{"title":"Track multi-recipient project updates","prompt":"Fetch the email thread 'thd_project_kickoff_789' from my agent's inbox to review all the messages between the team members and get the complete context on what was assigned to whom."}],"resultDescription":"Returns a JSON object representing the email thread, including metadata such as thread ID, subject, participants, timestamps, and the list of messages within the thread belonging to the specified pod.","failureModes":["Invalid pod_id returns 404 not found","Invalid thread_id returns 404 not found","Thread does not belong to the specified pod returns 403 or 404","Missing required path parameters returns 400 bad request","Unauthorized access returns 401","Pod or thread has been deleted returns 404"],"whenToPreferThis":"Use this endpoint when you need to read or inspect a specific known email thread within an AgentMail pod — for example, to check replies, monitor a conversation, or extract message content from an ongoing agentic email workflow. Prefer this over listing all threads when you already have the thread_id.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:39.078Z","isFirstParty":false}