# AgentMail - List Inbox Messages

> AgentMail - List Inbox Messages is a free API for AI agents from x402.api.agentmail.to, Free, status unknown (last checked 2026-10-09).

Retrieves a list of email messages from a specified AI agent inbox

## Facts

- Endpoint: GET https://x402.api.agentmail.to/v0/inboxes/%7Binbox_id%7D/messages?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentmail-list-inbox-messages-0b22c791
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hGHpCbUkGFvRJ0glFBGWv

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-list-inbox-messages-0b22c791
```

Example prompt: Check my AgentMail inbox abc-123 and show me all the messages that have come in — who sent them, what the subjects are, and when they arrived.

## When to prefer this

Use this endpoint when an AI agent needs to check or poll a specific managed inbox for incoming emails, especially in automated workflows where the agent needs to read replies, confirmations, or notifications sent to an agent-owned email address. Prefer this over general email APIs when working within the AgentMail ecosystem with agent-provisioned inboxes.

## Known failure modes

- Invalid or non-existent inbox_id returns 404 not found
- Unauthorized access returns 401 if credentials are missing or invalid
- Empty inbox returns an empty messages array
- Rate limiting may return 429 if too many requests are made
- Malformed inbox_id path parameter returns 400 bad request

## How this service works

Service: AgentMail API (/v0/inboxes/{inbox_id}/messages)

## Output

Returns a JSON list of email message objects from the specified inbox, including metadata such as sender address, subject line, message body, timestamps, and message IDs.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentmail-list-inbox-messages-0b22c791/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)