{"uid":"cap_cKa_DTQ3ZjAcAAf9eOin5","slug":"agentmail-entry-fc08a212","name":"AgentMail Get List Entry","description":"Get List Entry","url":"https://mpp.api.agentmail.to/v0/lists/:direction/:type/:entry?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["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."},"direction":{"enum":["send","receive","reply"],"type":"string","title":"Direction","description":"Direction of list entry."}}},"responseSchema":{"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."}}},"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/block list entry (email address or domain) for a given send/receive/reply direction in AgentMail.","exampleAgentPrompt":"Check if the email address spam@example.com is on the block list for incoming receive direction in AgentMail — I want to see its full entry details including when it was added.","exampleUseCases":null,"resultDescription":"Returns a ListEntry object containing the email address or domain, the organization ID, the direction (send/receive/reply), the list type (allow/block), the entry type (email or domain), creation timestamp, and an optional reason for the entry.","failureModes":["Entry not found — 404 if the specified email/domain is not present in the list","Invalid direction or type enum value — 400 validation error","Missing required path parameters — 400 or 422","Unauthorized — 401 if Bearer token is missing or invalid","Organization mismatch — entry exists but belongs to a different org"],"whenToPreferThis":"Use this endpoint when you need to check the status or details of a specific known email address or domain on an allow/block list. Prefer this over listing all entries when you already know the exact entry and want to confirm its presence, list type, direction, or creation date without scanning the full list.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:38:59.098Z","isFirstParty":false,"canonicalSlug":"agentmail-entry-be9caece"}