# AgentMail: List Domains

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

Retrieves a list of all email domains registered in the AgentMail organization

## Facts

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

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

Example prompt: Show me all the email domains registered in my AgentMail account so I know which ones are available for creating new agent inboxes.

## When to prefer this

Use this endpoint when you need to discover which email domains are available in an AgentMail organization before creating inboxes or sending email. Prefer this over hardcoding domain names or guessing — it provides the authoritative list of configured domains for the account.

## Known failure modes

- Unauthorized access if API credentials are missing or invalid (401)
- No domains returned if none have been configured yet (empty list)
- Service unavailable if AgentMail API is down (503)
- Payment required if x402 payment header is missing or insufficient (402)

## How this service works

List Domains

## Output

Returns a JSON list of email domain objects registered in the AgentMail organization, including domain names and associated metadata available for use with agent inboxes.

## 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": "ListDomainsResponse",
 "required": [
  "count",
  "domains"
 ],
 "properties": {
  "count": {
   "type": "integer",
   "title": "Count",
   "description": "Number of items returned."
  },
  "limit": {
   "type": "integer",
   "title": "Limit",
   "description": "Limit of number of items returned."
  },
  "domains": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "DomainItem",
    "required": [
     "domain_id",
     "feedback_enabled",
     "updated_at",
     "created_at"
    ],
    "properties": {
     "pod_id": {
      "type": "string",
      "title": "PodId",
      "description": "ID of pod."
     },
     "client_id": {
      "type": "string",
      "title": "ClientId",
      "description": "Client ID of domain."
     },
     "domain_id": {
      "type": "string",
      "title": "DomainId",
      "description": "The name of the domain. (e.g., \" your-domain.com\")"
     },
     "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "Time at which the domain was created."
     },
     "updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "Time at which the domain was last updated."
     },
     "feedback_enabled": {
      "type": "boolean",
      "title": "FeedbackEnabled",
      "description": "Bounce and complaint notifications are sent to your inboxes."
     }
    }
   },
   "description": "Ordered by `created_at` descending."
  },
  "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-31627992/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)