# AgentMail: List Pods

> AgentMail: List Pods is a paid API for AI agents from x402.api.agentmail.to, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15, last successful call 2026-06-19).

Retrieves the list of pods associated with the authenticated AgentMail organization

## Facts

- Endpoint: GET https://x402.api.agentmail.to/v0/pods
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Last successful call: 2026-06-19
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentmail-aeebe46b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QRDi1RTtktSjwV31NFTLd

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

Example prompt: Show me all the pods currently set up in my AgentMail organization so I can see what email infrastructure is available for my agents.

## When to prefer this

Use this endpoint when you need to enumerate the pods available in an AgentMail organization before creating inboxes, managing email routing, or understanding the agent email infrastructure layout. Prefer this over List Inboxes or List Domains when the goal is specifically to inspect pod-level groupings of email resources.

## Known failure modes

- Authentication failure — invalid or missing credentials returns 401 Unauthorized
- Organization not found or no pods configured returns empty list
- Rate limiting or quota exceeded returns 429 Too Many Requests
- Server error returns 500 with error details
- x402 payment failure if payment header is missing or invalid

## How this service works

List Pods

## Output

A JSON list of pods belonging to the authenticated organization, including pod identifiers and associated metadata such as configuration details and status.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "title": "Limit",
   "description": "Limit of number of items returned."
  },
  "ascending": {
   "type": "boolean",
   "title": "Ascending",
   "description": "Sort in ascending temporal order."
  },
  "page_token": {
   "type": "string",
   "title": "PageToken",
   "description": "Page token for pagination."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ListPodsResponse",
 "required": [
  "count",
  "pods"
 ],
 "properties": {
  "pods": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "Pod",
    "required": [
     "pod_id",
     "name",
     "updated_at",
     "created_at"
    ],
    "properties": {
     "name": {
      "type": "string",
      "title": "Name",
      "description": "Name of pod."
     },
     "pod_id": {
      "type": "string",
      "title": "PodId",
      "description": "ID of pod."
     },
     "client_id": {
      "type": "string",
      "title": "ClientId",
      "description": "Client ID of pod."
     },
     "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "Time at which pod was created."
     },
     "updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "Time at which pod was last updated."
     }
    }
   },
   "description": "Ordered by `created_at` descending."
  },
  "count": {
   "type": "integer",
   "title": "Count",
   "description": "Number of items returned."
  },
  "limit": {
   "type": "integer",
   "title": "Limit",
   "description": "Limit of number of items returned."
  },
  "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-aeebe46b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.api.agentmail.to](https://www.zero.xyz/host/x402.api.agentmail.to/llms.txt)