{"uid":"cap_BkOH8WqtSrbsLhDb3mFOr","slug":"agentmail-threads-d4f30fbb","name":"AgentMail List Threads","description":"List Threads","url":"https://mpp.api.agentmail.to/v0/pods/:pod_id/threads?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["pod_id"],"properties":{"after":{"type":"string","title":"After","format":"date-time","description":"Timestamp after which to filter by."},"limit":{"type":"integer","title":"Limit","description":"Limit of number of items returned."},"before":{"type":"string","title":"Before","format":"date-time","description":"Timestamp before which to filter by."},"labels":{"type":"array","items":{"type":"string"},"title":"Labels","description":"Labels to filter by."},"pod_id":{"type":"string","title":"PodId","description":"ID of pod."},"ascending":{"type":"boolean","title":"Ascending","description":"Sort in ascending temporal order."},"page_token":{"type":"string","title":"PageToken","description":"Page token for pagination."},"include_spam":{"type":"boolean","title":"IncludeSpam","description":"Include spam in results."},"include_trash":{"type":"boolean","title":"IncludeTrash","description":"Include trash in results."},"include_blocked":{"type":"boolean","title":"IncludeBlocked","description":"Include blocked in results."}}},"responseSchema":{"type":"object","title":"ListThreadsResponse","required":["count","threads"],"properties":{"count":{"type":"integer","title":"Count","description":"Number of items returned."},"limit":{"type":"integer","title":"Limit","description":"Limit of number of items returned."},"threads":{"type":"array","items":{"type":"object","title":"ThreadItem","required":["inbox_id","thread_id","labels","timestamp","senders","recipients","last_message_id","message_count","size","updated_at","created_at"],"properties":{"size":{"type":"integer","title":"ThreadSize","description":"Size of thread in bytes."},"labels":{"type":"array","items":{"type":"string"},"title":"ThreadLabels","description":"Labels of thread."},"preview":{"type":"string","title":"ThreadPreview","description":"Text preview of last message in thread."},"senders":{"type":"array","items":{"type":"string"},"title":"ThreadSenders","description":"Senders in thread. In format `username@domain.com` or `Display Name <username@domain.com>`."},"subject":{"type":"string","title":"ThreadSubject","description":"Subject of thread."},"inbox_id":{"type":"string","title":"InboxId","description":"The ID of the inbox."},"thread_id":{"type":"string","title":"ThreadId","description":"ID of thread."},"timestamp":{"type":"string","title":"ThreadTimestamp","format":"date-time","description":"Timestamp of last sent or received message."},"created_at":{"type":"string","title":"ThreadCreatedAt","format":"date-time","description":"Time at which thread was created."},"recipients":{"type":"array","items":{"type":"string"},"title":"ThreadRecipients","description":"Recipients in thread. In format `username@domain.com` or `Display Name <username@domain.com>`."},"updated_at":{"type":"string","title":"ThreadUpdatedAt","format":"date-time","description":"Time at which thread was last updated."},"attachments":{"type":"array","items":{"type":"object","title":"Attachment","required":["attachment_id","size"],"properties":{"size":{"$ref":"#/components/schemas/type_attachments:AttachmentSize"},"filename":{"$ref":"#/components/schemas/type_attachments:AttachmentFilename"},"content_id":{"$ref":"#/components/schemas/type_attachments:AttachmentContentId"},"content_type":{"$ref":"#/components/schemas/type_attachments:AttachmentContentType"},"attachment_id":{"$ref":"#/components/schemas/type_attachments:AttachmentId"},"content_disposition":{"$ref":"#/components/schemas/type_attachments:AttachmentContentDisposition"}}},"title":"ThreadAttachments","description":"Attachments in thread."},"message_count":{"type":"integer","title":"ThreadMessageCount","description":"Number of messages in thread."},"sent_timestamp":{"type":"string","title":"ThreadSentTimestamp","format":"date-time","description":"Timestamp of last sent message."},"last_message_id":{"type":"string","title":"ThreadLastMessageId","description":"ID of last message in thread."},"received_timestamp":{"type":"string","title":"ThreadReceivedTimestamp","format":"date-time","description":"Timestamp of last received message."}}},"description":"Ordered by `timestamp` descending."},"next_page_token":{"type":"string","title":"PageToken","description":"Page token for pagination."}}},"example":null,"exampleRequest":null,"tags":["email","inboxes","domains","drafts","threads","webhooks","messaging","ai","social"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"unknown","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":null,"accepted":[]},"paymentMethods":[],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Lists email threads within a specified AgentMail pod, with filtering by labels, date range, and inclusion of spam/trash/blocked items","exampleAgentPrompt":"Show me the latest 20 email threads in my AgentMail pod 'pod_abc123', including only those labeled 'support', from the past week — skip spam and trash.","exampleUseCases":null,"resultDescription":"Returns a list of ThreadItem objects, each containing thread_id, inbox_id, subject, senders, recipients, labels, a text preview of the last message, timestamp, message count, size in bytes, attachment metadata, and created_at/updated_at timestamps. Also returns a count and limit for pagination purposes.","failureModes":["Invalid pod_id returns 404 Not Found","Missing or invalid Authorization bearer token returns 401 Unauthorized","Malformed date-time format for before/after filters returns 400 Bad Request","Invalid page_token returns 400 or empty result","Empty pod with no threads returns count=0 and empty threads array","Rate limiting may return 429 Too Many Requests"],"whenToPreferThis":"Use this endpoint when an AI agent needs to enumerate or browse email conversations within a specific AgentMail pod, particularly when filtering by label, date range, or inclusion of spam/trash. Prefer this over message-level endpoints when you need thread-level summaries and metadata rather than full message content.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:44:34.279Z","isFirstParty":false,"canonicalSlug":"agentmail-threads-ec3ce2d0"}