# Mermail List Mailboxes

> Mermail List Mailboxes is a paid API for AI agents from console.mermail.app, paid per call via x402, $2/call, status unknown (last checked 2026-10-11).

Retrieves all mailboxes configured for an AI agent in the Mermail workspace, including their email addresses, receiving status, and identifiers.

## Facts

- Endpoint: GET https://console.mermail.app/api/agent/v1/mailboxes?utm_source=zero.xyz
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mermail-list-mailboxes-28351d2d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l2OWl_lepwObdPmDnACei

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 mermail-list-mailboxes-28351d2d
```

Example prompt: Show me all the mailboxes set up in my Mermail workspace so I can see which email addresses my agent can receive messages on and whether they're ready to use.

## When to prefer this

Use this endpoint when an AI agent needs to discover or enumerate its available email mailboxes before reading messages, routing communications, or verifying inbox readiness. It is the correct first step before calling any message-fetching or inbox-management endpoints within the Mermail ecosystem.

## Known failure modes

- Authentication failure (missing or invalid payment/auth header) returns 402 Payment Required
- Workspace with no configured mailboxes returns an empty array
- Invalid query parameters may return 400 Bad Request
- Service unavailability returns 503 or 500 error
- Network timeout if the Mermail API is unresponsive

## How this service works

An inbox and wallet for your AI agent. Find and nurture sales leads, resolve customer support, and handle online purchases with controlled payments.

## Output

Returns a list of mailbox objects, each containing the mailbox ID, human-readable name, assigned email address, UUID public_id, workspace_id, a boolean can_receive flag, and a receiving_status enum value ('ready', 'disabled', or 'unavailable').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "id",
       "public_id",
       "workspace_id",
       "email",
       "name"
      ],
      "properties": {
       "id": {
        "type": "string"
       },
       "name": {
        "type": "string"
       },
       "email": {
        "type": "string",
        "format": "email"
       },
       "public_id": {
        "type": "string",
        "format": "uuid"
       },
       "can_receive": {
        "type": "boolean"
       },
       "workspace_id": {
        "type": "string"
       },
       "receiving_status": {
        "enum": [
         "ready",
         "disabled",
         "unavailable"
        ],
        "type": "string"
       }
      },
      "additionalProperties": true
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "mailbox_1",
  "name": "Support agent",
  "email": "agent@mermail.app",
  "public_id": "11111111-1111-4111-8111-111111111111",
  "can_receive": true,
  "workspace_id": "workspace_1",
  "receiving_status": "ready"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mermail-list-mailboxes-28351d2d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from console.mermail.app](https://www.zero.xyz/host/console.mermail.app/llms.txt)