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

# Get Thread

> Retrieve a complete conversation thread including all messages in chronological sequence.

Retrieve the full conversation thread by ID. When AI agents process ongoing emails, accessing the complete thread ensures the model has the full conversational context.

### Path Parameters

<ParamField path="id" type="string" required>
  The unique ID of the conversation thread (`thrd_...`).
</ParamField>

### Response

<ResponseField name="data" type="object">
  <Expandable title="properties">
    <ResponseField name="id" type="string">
      Unique ID of the thread.
    </ResponseField>

    <ResponseField name="inboxId" type="string">
      The inbox associated with this thread.
    </ResponseField>

    <ResponseField name="subject" type="string">
      Original subject line.
    </ResponseField>

    <ResponseField name="messageCount" type="number">
      Total number of messages in the thread.
    </ResponseField>

    <ResponseField name="messages" type="array">
      Ordered list of messages in this thread.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://api.gork.email/v1/threads/thrd_128bca90f4 \
    -H "Authorization: Bearer gk_live_YOUR_API_KEY"
  ```

  ```typescript TypeScript theme={null}
  import { GorkClient } from "@gorkmail/sdk"

  const client = new GorkClient({ apiKey: process.env.GORK_API_KEY })

  const thread = await client.threads.get("thrd_128bca90f4")
  console.log(`Thread contains ${thread.messages.length} messages.`)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": {
      "id": "thrd_128bca90f4",
      "inboxId": "inbox_728af980b4e",
      "subject": "Re: Partnership opportunity",
      "lastMessageAt": "2026-09-07T12:30:00.000Z",
      "messages": [
        {
          "id": "msg_001",
          "direction": "inbound",
          "from": "prospect@acmecorp.com",
          "to": ["alex@outbound.yourdomain.com"],
          "text": "Hi Alex, we would be interested in seeing a demo.",
          "createdAt": "2026-09-07T11:00:00.000Z"
        },
        {
          "id": "msg_002",
          "direction": "outbound",
          "from": "alex@outbound.yourdomain.com",
          "to": ["prospect@acmecorp.com"],
          "text": "Sounds great! How does Thursday at 2pm PT look?",
          "createdAt": "2026-09-07T11:15:00.000Z"
        }
      ]
    }
  }
  ```
</ResponseExample>