# 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-12).

Retrieves a specific allow/block list entry for an inbox, identified by direction, list type, and email address or domain.

## Facts

- Endpoint: GET https://mpp.api.agentmail.to/v0/inboxes/:inbox_id/lists/:direction/:type/:entry?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-12
- 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-be9caece
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YA3oAnG0dNOyfCI3IxSki

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-be9caece
```

Example prompt: Check if the domain 'spammy.com' is on the block list for the receive direction on inbox 'inbox_abc123' in AgentMail.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Get List Entry

## Output

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.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentmail-entry-be9caece/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)