# AgentMail Get Pod List Entry

> AgentMail Get Pod 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 or block list entry (email address or domain) for a given pod and direction in AgentMail.

## Facts

- Endpoint: GET https://mpp.api.agentmail.to/v0/pods/:pod_id/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-0a720f0f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MyHK5eeP0rWTPbSU4D22B

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-0a720f0f
```

Example prompt: Can you check whether 'spam@example.com' is on the block list for receiving messages in my AgentMail pod 'pod_abc123'?

## When to prefer this

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.

## Known failure modes

- 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)

## How this service works

Get List Entry

## Output

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.

## Request schema (JSON Schema)

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

## 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-0a720f0f/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)