{"uid":"cap_MyHK5eeP0rWTPbSU4D22B","slug":"agentmail-entry-0a720f0f","name":"AgentMail Get Pod List Entry","description":"Get List Entry","url":"https://mpp.api.agentmail.to/v0/pods/:pod_id/lists/:direction/:type/:entry?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["pod_id","direction","type","entry"],"properties":{"type":{"enum":["allow","block"],"type":"string","title":"ListType","description":"Type of list entry."},"entry":{"type":"string","description":"Email address or domain."},"pod_id":{"type":"string","title":"PodId","description":"ID of pod."},"direction":{"enum":["send","receive","reply"],"type":"string","title":"Direction","description":"Direction of list entry."}}},"responseSchema":{"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."}}},"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":"Retrieves a specific allow or block list entry (email address or domain) for a given pod and direction in AgentMail.","exampleAgentPrompt":"Can you check whether 'spam@example.com' is on the block list for receiving messages in my AgentMail pod 'pod_abc123'?","exampleUseCases":null,"resultDescription":"Returns a PodListEntry object containing the entry (email or domain), pod_id, organization_id, direction (send/receive/reply), list_type (allow/block), entry_type (email/domain), created_at timestamp, and optionally a reason for the entry and inbox_id if inbox-scoped.","failureModes":["Entry not found — the specified email/domain is not present in the list for the given direction and type (404)","Invalid pod_id — the pod does not exist or is inaccessible (404 or 403)","Invalid direction enum value — must be one of send, receive, reply (422 validation error)","Invalid type enum value — must be one of allow, block (422 validation error)","Missing or invalid Authorization header — authentication failure (401)","Entry string malformed — not a valid email or domain format (422)"],"whenToPreferThis":"Use this endpoint when you need to verify whether a specific email address or domain exists in a pod's allow or block list, and want to retrieve its metadata (creation time, reason, scope). Prefer this over listing all entries when you already know the exact entry value and need to confirm its presence or details.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:37:02.094Z","isFirstParty":false,"canonicalSlug":"agentmail-entry-0a720f0f"}