# AgentMail Get Thread by ID

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

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

## Facts

- Endpoint: GET https://x402.api.agentmail.to/v0/threads/%7Bthread_id%7D
- Price: Free
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentmail-get-thread-by-id-28c99d92
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9y1VJtD26q-di5tvTqaqC

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-thread-by-id-28c99d92
```

Example prompt: Can you pull up the email thread with ID 'thrd_abc123' from my AgentMail inbox so I can see the full conversation?

## When to prefer this

Use this endpoint when you already have a specific thread_id and need to retrieve the full details of that email conversation. Prefer this over listing all threads when you know exactly which thread you need. Ideal for agentic workflows that track thread IDs across steps and need to check the latest state of a specific conversation.

## Known failure modes

- Thread not found (404) if thread_id does not exist or belongs to a different workspace
- Unauthorized (401/403) if the agent's credentials are invalid or expired
- Invalid thread_id format returns a 400 bad request
- Empty response if the thread has been deleted
- Rate limiting errors if too many requests are made in quick succession

## How this service works

AgentMail gives AI agents real email inboxes. Create, send, receive, and search messages via REST API — built for autonomous agents and agentic workflows.

## Output

Returns a JSON object representing the email thread, including thread ID, messages, participants, subject, timestamps, and other thread metadata associated with that conversation in the AgentMail workspace.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "pathParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "thread_id"
     ],
     "properties": {
      "thread_id": {
       "type": "string"
      }
     },
     "additionalProperties": false
    },
    "queryParams": {
     "type": "object",
     "properties": {},
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

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

## More

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