# AgentMail Get List Entry

> AgentMail Get List Entry is a free API for AI agents from AgentMail at mpp.api.agentmail.to, Free, status unknown (last checked 2026-10-11).

Retrieves a specific allow/block list entry (email address or domain) for a given send/receive/reply direction in AgentMail.

## Facts

- Endpoint: GET https://mpp.api.agentmail.to/v0/lists/:direction/:type/:entry?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: AgentMail
- Docs: https://docs.agentmail.to
- Website: https://agentmail.to
- Tags: email, inboxes, domains, drafts, threads, webhooks, messaging, ai, social
- Canonical page: https://www.zero.xyz/c/agentmail-entry-fc08a212
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cKa_DTQ3ZjAcAAf9eOin5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentmail-entry-fc08a212
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Get List Entry

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentmail-entry-fc08a212/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mpp.api.agentmail.to](https://www.zero.xyz/host/mpp.api.agentmail.to/llms.txt)