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

Lists allow or block list entries for a given email direction (send, receive, or reply) with pagination support

## Facts

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

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

Example prompt: Show me all the blocked entries on AgentMail for the receive direction — list up to 50 at a time.

## When to prefer this

Use this endpoint when you need to inspect or audit the current allow/block list configuration for an AgentMail organization across different email directions. Prefer this over alternatives when you need to enumerate filtering rules programmatically, verify whether a domain or address is on a list, or paginate through large rule sets.

## Known failure modes

- Invalid direction value (not send/receive/reply) — 422 validation error
- Invalid type value (not allow/block) — 422 validation error
- Missing required path parameters — 422 unprocessable entity
- Unauthorized or missing Bearer token — 401 authentication error
- Invalid page_token — 400 bad request or empty result set
- Organization has no entries for the specified combination — returns empty entries array with count 0

## How this service works

List Entries

## Output

Returns a paginated list of list entries (email addresses or domains) for the specified direction and list type, including each entry's value, type (email or domain), direction, list type, creation timestamp, optional reason, and organization ID, along with item count and a next page token for pagination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "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."
  },
  "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": "ListListEntriesResponse",
 "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": "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."
     }
    }
   },
   "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-b9aff468/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)