> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Inbound Email

> Get a specific inbound email by ID

## Authentication

Requires `X-Agent-ID` header with your wallet address.

Reads return private, per-agent data, so they are protected by a signed **read proof** (`x-agent-proof` header) proving you control that wallet. The OneShot SDK signs and sends this automatically (TypeScript ≥ 0.25.0, Python ≥ 0.17.0). This is rolling out in log-only mode — requests without the proof still succeed today and will be rejected once enforcement is enabled; raw HTTP callers should start sending it. See [Read Proof Authentication](/sdk/overview#read-authentication).

## Path Parameters

<ParamField path="emailId" type="string" required>
  The unique identifier of the email to retrieve
</ParamField>

## Response

<ResponseField name="id" type="string">
  Email identifier
</ResponseField>

<ResponseField name="from" type="string">
  Sender email address
</ResponseField>

<ResponseField name="subject" type="string">
  Email subject
</ResponseField>

<ResponseField name="body" type="string">
  Plain text body
</ResponseField>

<ResponseField name="body_html" type="string">
  HTML body
</ResponseField>

<ResponseField name="received_at" type="string">
  ISO 8601 timestamp
</ResponseField>

<ResponseField name="thread_id" type="string">
  Thread identifier
</ResponseField>

<ResponseField name="attachments" type="array">
  Array of attachment objects (same format as list endpoint)
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://win.oneshotagent.com/v1/tools/inbox/email_123 \
    -H "X-Agent-ID: <your_agent_uuid>"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    `https://win.oneshotagent.com/v1/tools/inbox/${emailId}`,
    {
      headers: {
        "X-Agent-ID": agentUuid,
      },
    },
  );
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "email_123",
    "from": "sender@example.com",
    "subject": "Re: Your inquiry",
    "body": "Thanks for reaching out!",
    "body_html": "<p>Thanks for reaching out!</p>",
    "received_at": "2025-12-28T12:00:00Z",
    "thread_id": "thread_abc",
    "attachments": []
  }
  ```
</ResponseExample>