{"uid":"cap_9y1VJtD26q-di5tvTqaqC","slug":"agentmail-get-thread-by-id-28c99d92","name":"AgentMail Get Thread by ID","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/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":["thread_id"],"properties":{"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_oEDoIUQQC28TgGmLDDlm9","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 a specific email thread by its thread ID from an AI agent's AgentMail inbox","exampleAgentPrompt":"Can you pull up the email thread with ID 'thrd_abc123' from my AgentMail inbox so I can see the full conversation?","exampleUseCases":[{"title":"Customer support escalation tracking","prompt":"I need you to check thread 'thrd_support_001' from my AgentMail inbox and tell me what the current status is and who all is involved in that customer conversation."},{"title":"Contract negotiation conversation review","prompt":"Pull up the email thread with ID 'thrd_contract_draft_v2' so I can see all the back-and-forth messages between our legal team and the vendor about the terms."},{"title":"Project approval workflow monitoring","prompt":"Can you fetch the thread 'thrd_proj_approval_q4' from my agent inbox and show me the latest messages to see if we've gotten sign-off from the finance department yet?"}],"resultDescription":"Returns a JSON object representing the email thread, including thread ID, messages, participants, subject, timestamps, and other thread metadata associated with that conversation in the AgentMail workspace.","failureModes":["Thread not found (404) if thread_id does not exist or belongs to a different workspace","Unauthorized (401/403) if the agent's credentials are invalid or expired","Invalid thread_id format returns a 400 bad request","Empty response if the thread has been deleted","Rate limiting errors if too many requests are made in quick succession"],"whenToPreferThis":"Use this endpoint when you already have a specific thread_id and need to retrieve the full details of that email conversation. Prefer this over listing all threads when you know exactly which thread you need. Ideal for agentic workflows that track thread IDs across steps and need to check the latest state of a specific conversation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:30:22.520Z","isFirstParty":false}