{"uid":"cap_KOTVffpo1wXDhfJKKSw-k","slug":"agentmail-type-1f5ba5df","name":"AgentMail List Pod Allow/Block Entries","description":"List Entries","url":"https://mpp.api.agentmail.to/v0/pods/:pod_id/lists/:direction/:type","method":"GET","headers":{},"bodySchema":{"type":"object","required":["pod_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."},"pod_id":{"type":"string","title":"PodId","description":"ID of pod."},"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":"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 pod, filtered by direction (send/receive/reply) and type (allow/block)","exampleAgentPrompt":"Show me all the blocked entries for the 'receive' direction on pod abc123 in AgentMail — I want to see which email addresses and domains are on the block list.","exampleUseCases":null,"resultDescription":"Returns a paginated list of allow or block list entries for the specified pod and direction. Each entry includes the email address or domain, whether it's email- or domain-scoped, the direction, list type, creation timestamp, optional inbox scope, optional reason, and organization ID. Also includes a count and optional next_page_token for pagination.","failureModes":["Invalid pod_id returns 404 not found","Invalid direction or type enum value returns 400 bad request","Missing required path parameters returns 422 unprocessable entity","Expired or missing Authorization token returns 401 unauthorized","No entries exist for the given filters returns empty entries array with count 0","Invalid page_token returns 400 or empty results"],"whenToPreferThis":"Use this endpoint when you need to inspect the current state of allow or block lists for a specific pod in AgentMail — for example, to audit which senders are blocked, verify that an address was added to an allowlist, or enumerate all access-control entries before making changes. Prefer this over creating or deleting entries when the goal is read-only inspection or compliance checking.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-21T18:45:57.925Z","isFirstParty":false}