# AgentMail List Entries

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

Lists all allow or block list entries for a specific inbox, filtered by direction (send/receive/reply) and list type (allow/block)

## Facts

- Endpoint: GET https://mpp.api.agentmail.to/v0/inboxes/:inbox_id/lists/:direction/:type?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-type-9372b3d4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1C_Nuxq6CblPV9YKaNGXC

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-type-9372b3d4
```

Example prompt: Show me all the blocked entries in the receive direction for inbox 'inbox_abc123' on AgentMail — list up to 50 results.

## When to prefer this

Use this endpoint when you need to inspect the current allow or block list configuration for a specific inbox in AgentMail, particularly when auditing filtering rules, debugging email delivery issues, or building UIs that display inbox access control settings. Prefer this over the Create List Entry endpoint when you only need to read existing entries without modification.

## Known failure modes

- Invalid inbox_id returns 404 not found
- Invalid direction value (not send/receive/reply) returns 400 validation error
- Invalid type value (not allow/block) returns 400 validation error
- Missing or invalid Authorization header returns 401 unauthorized
- No entries matching criteria returns empty entries array with count 0
- Invalid page_token returns 400 or empty result

## How this service works

List Entries

## Output

Returns a paginated list of allow or block list entries for the specified inbox and direction, including each entry's email address or domain, entry type, reason, timestamps, and organization/pod IDs, along with a count and optional next page token.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "inbox_id",
  "direction",
  "type"
 ],
 "properties": {
  "type": {
   "enum": [
    "allow",
    "block"
   ],
   "type": "string",
   "title": "ListType",
   "description": "Type of list entry."
  },
  "limit": {
   "type": "integer",
   "title": "Limit",
   "description": "Limit of number of items returned."
  },
  "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."
  },
  "page_token": {
   "type": "string",
   "title": "PageToken",
   "description": "Page token for pagination."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "PodListListEntriesResponse",
 "required": [
  "count",
  "entries"
 ],
 "properties": {
  "count": {
   "type": "integer",
   "title": "Count",
   "description": "Number of items returned."
  },
  "limit": {
   "type": "integer",
   "title": "Limit",
   "description": "Limit of number of items returned."
  },
  "entries": {
   "type": "array",
   "items": {
    "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."
     }
    }
   },
   "description": "Ordered by entry ascending."
  },
  "next_page_token": {
   "type": "string",
   "title": "PageToken",
   "description": "Page token for pagination."
  }
 }
}
```

## More

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