# AgentMail Get Message by ID

> AgentMail Get Message by ID is a free API for AI agents from x402.api.agentmail.to, Free, status unknown (last checked 2026-09-10).

Retrieves a single email message from a specific AgentMail inbox by message ID

## Facts

- Endpoint: GET https://x402.api.agentmail.to/v0/inboxes/%7Binbox_id%7D/messages/%7Bmessage_id%7D
- Price: Free
- Status: unknown
- Last checked: 2026-09-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentmail-get-message-by-id-fbaa7151
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IY1Ha2541UvjjcmzDoZyH

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-get-message-by-id-fbaa7151
```

Example prompt: Fetch the full content of message msg_abc123 from inbox inbox_xyz789 in my AgentMail account so I can see what it says.

## When to prefer this

Use this endpoint when you need to retrieve the full details of a specific, known email message from an AgentMail inbox and already have both the inbox_id and message_id. Prefer this over listing endpoints when you only need one specific message rather than browsing multiple messages.

## Known failure modes

- inbox_id not found — 404 with inbox not found error
- message_id not found in the specified inbox — 404 with message not found error
- Invalid or missing authentication — 401 unauthorized
- Malformed inbox_id or message_id path parameters — 400 bad request
- Rate limit exceeded — 429 too many requests

## How this service works

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

## Output

Returns a JSON object representing a single email message, including fields such as subject, sender, recipient addresses, body content, timestamps, and any metadata associated with the message in the specified AgentMail inbox.

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentmail-get-message-by-id-fbaa7151/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)