{"uid":"cap_KJlx2mEkwp7n3X8NkxzEe","slug":"agentmail-type-b9aff468","name":"AgentMail List Entries","description":"List Entries","url":"https://mpp.api.agentmail.to/v0/lists/:direction/:type?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["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."},"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":"ListListEntriesResponse","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":"ListEntry","required":["entry","organization_id","direction","list_type","entry_type","created_at"],"properties":{"entry":{"type":"string","description":"Email address or domain of list entry."},"reason":{"type":"string","description":"Reason for adding the entry."},"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":"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 allow or block list entries for a given email direction (send, receive, or reply) with pagination support","exampleAgentPrompt":"Show me all the blocked entries on AgentMail for the receive direction — list up to 50 at a time.","exampleUseCases":null,"resultDescription":"Returns a paginated list of list entries (email addresses or domains) for the specified direction and list type, including each entry's value, type (email or domain), direction, list type, creation timestamp, optional reason, and organization ID, along with item count and a next page token for pagination.","failureModes":["Invalid direction value (not send/receive/reply) — 422 validation error","Invalid type value (not allow/block) — 422 validation error","Missing required path parameters — 422 unprocessable entity","Unauthorized or missing Bearer token — 401 authentication error","Invalid page_token — 400 bad request or empty result set","Organization has no entries for the specified combination — returns empty entries array with count 0"],"whenToPreferThis":"Use this endpoint when you need to inspect or audit the current allow/block list configuration for an AgentMail organization across different email directions. Prefer this over alternatives when you need to enumerate filtering rules programmatically, verify whether a domain or address is on a list, or paginate through large rule sets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:39:18.724Z","isFirstParty":false,"canonicalSlug":"agentmail-type-9372b3d4"}