{"uid":"cap_YA3oAnG0dNOyfCI3IxSki","slug":"agentmail-entry-be9caece","name":"AgentMail Get List Entry","description":"Get List Entry","url":"https://mpp.api.agentmail.to/v0/inboxes/:inbox_id/lists/:direction/:type/:entry?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["inbox_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."},"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."}}},"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":"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":"Retrieves a specific allow/block list entry for an inbox, identified by direction, list type, and email address or domain.","exampleAgentPrompt":"Check if the domain 'spammy.com' is on the block list for the receive direction on inbox 'inbox_abc123' in AgentMail.","exampleUseCases":[{"title":"Verify sender domain before adding to allowlist","prompt":"Before I add sales@partner.com to my inbox's allow list, can you check if that domain is already there? I want to see when it was added and why."},{"title":"Confirm blocked email status before unblocking","prompt":"I think I might have blocked john.doe@oldcompany.com from replying to my inbox. Can you look up whether that address is actually on my block list and when I blocked it?"},{"title":"Check outgoing message restrictions for a recipient","prompt":"I need to verify if marketing@client.net is allowed in the send direction for my AI agent inbox. Pull up that entry for me so I can see the details."}],"resultDescription":"Returns a PodListEntry object containing the email address or domain, the direction (send/receive/reply), list type (allow/block), entry type (email or domain), organization ID, pod ID, creation timestamp, optional inbox ID, and an optional reason the entry was added.","failureModes":["Entry not found (404) — the specified email/domain is not present on the given list","Invalid direction or list type enum value — request rejected with validation error","Inbox not found (404) — inbox_id does not exist or is not accessible","Unauthorized (401) — missing or invalid Bearer token","Malformed entry value — email or domain string is not parseable"],"whenToPreferThis":"Use this endpoint when you need to verify whether a specific email address or domain already exists on an inbox's allow or block list before adding it, or when you need to retrieve metadata (creation time, reason, entry type) about an existing list entry. Prefer this over listing all entries when you already know the exact address/domain and want a direct lookup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:38:45.320Z","isFirstParty":false,"canonicalSlug":"agentmail-entry-be9caece"}