# AgentMail Get Email Thread

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

Retrieves a specific email thread by thread ID from an AI agent's inbox

## Facts

- Endpoint: GET https://x402.api.agentmail.to/v0/inboxes/%7Binbox_id%7D/threads/%7Bthread_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-email-thread-318f6e71
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FPcTm750N3w5rf463Lqn_

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-email-thread-318f6e71
```

Example prompt: Pull up the full email thread with thread ID 'thrd_abc123' from my AgentMail inbox 'inbox_xyz456' so I can see all the messages in that conversation.

## When to prefer this

Use this endpoint when you need to retrieve the full message history of a specific email thread within a known AgentMail inbox. Prefer this over listing all threads when you already have the thread_id and need complete thread context for processing, replying, or analyzing a conversation.

## Known failure modes

- Invalid inbox_id returns 404 not found
- Invalid thread_id returns 404 not found
- Unauthorized access returns 401 or 403
- Thread belongs to a different inbox returns error
- Empty response if thread has no messages
- Rate limiting may return 429 too many requests

## How this service works

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

## Output

Returns a JSON object representing the email thread, including all messages within the thread, message metadata (sender, recipient, subject, timestamps), and thread-level details for the specified inbox and thread ID.

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentmail-get-email-thread-318f6e71/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)