{"uid":"cap_1C_Nuxq6CblPV9YKaNGXC","slug":"agentmail-type-9372b3d4","name":"AgentMail List Entries","description":"List Entries","url":"https://mpp.api.agentmail.to/v0/inboxes/:inbox_id/lists/:direction/:type?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["inbox_id","direction","type"],"properties":{"type":{"enum":["allow","block"],"type":"string","title":"ListType","description":"Type of list entry."},"limit":{"type":"integer","title":"Limit","description":"Limit of number of items returned."},"inbox_id":{"type":"string","title":"InboxId","description":"The ID of the inbox."},"direction":{"enum":["send","receive","reply"],"type":"string","title":"Direction","description":"Direction of list entry."},"page_token":{"type":"string","title":"PageToken","description":"Page token for pagination."}}},"responseSchema":{"type":"object","title":"PodListListEntriesResponse","required":["count","entries"],"properties":{"count":{"type":"integer","title":"Count","description":"Number of items returned."},"limit":{"type":"integer","title":"Limit","description":"Limit of number of items returned."},"entries":{"type":"array","items":{"type":"object","title":"PodListEntry","required":["entry","organization_id","direction","list_type","entry_type","created_at","pod_id"],"properties":{"entry":{"type":"string","description":"Email address or domain of list entry."},"pod_id":{"type":"string","description":"ID of pod."},"reason":{"type":"string","description":"Reason for adding the entry."},"inbox_id":{"type":"string","description":"ID of inbox, if entry is inbox-scoped."},"direction":{"enum":["send","receive","reply"],"type":"string","title":"Direction","description":"Direction of list entry."},"list_type":{"enum":["allow","block"],"type":"string","title":"ListType","description":"Type of list entry."},"created_at":{"type":"string","format":"date-time","description":"Time at which entry was created."},"entry_type":{"enum":["email","domain"],"type":"string","title":"EntryType","description":"Whether the entry is an email address or domain."},"organization_id":{"type":"string","title":"OrganizationId","description":"ID of organization."}}},"description":"Ordered by entry ascending."},"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":"unprobed","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 all allow or block list entries for a specific inbox, filtered by direction (send/receive/reply) and list type (allow/block)","exampleAgentPrompt":"Show me all the blocked entries in the receive direction for inbox 'inbox_abc123' on AgentMail — list up to 50 results.","exampleUseCases":[{"title":"Audit incoming sender restrictions","prompt":"Can you show me everyone who's blocked from sending emails to my inbox? I need to review my receive block list to make sure we haven't accidentally blocked any important contacts."},{"title":"Verify outbound email domain blocks","prompt":"Pull up all the domains we're blocking for outgoing emails from my agent inbox — I want to make sure our send block list is configured correctly before we start using this account for customer communications."},{"title":"Debug reply filtering configuration","prompt":"I'm having trouble with email replies not getting through to one of my inboxes. Can you list all the blocked entries in the reply direction so I can see if someone's accidentally blocked there?"}],"resultDescription":"Returns a paginated list of allow or block list entries for the specified inbox and direction, including each entry's email address or domain, entry type, reason, timestamps, and organization/pod IDs, along with a count and optional next page token.","failureModes":["Invalid inbox_id returns 404 not found","Invalid direction value (not send/receive/reply) returns 400 validation error","Invalid type value (not allow/block) returns 400 validation error","Missing or invalid Authorization header returns 401 unauthorized","No entries matching criteria returns empty entries array with count 0","Invalid page_token returns 400 or empty result"],"whenToPreferThis":"Use this endpoint when you need to inspect the current allow or block list configuration for a specific inbox in AgentMail, particularly when auditing filtering rules, debugging email delivery issues, or building UIs that display inbox access control settings. Prefer this over the Create List Entry endpoint when you only need to read existing entries without modification.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:39:21.481Z","isFirstParty":false,"canonicalSlug":"agentmail-type-9372b3d4"}