# Get a thread

> Returns the raw messages in a single email thread, chronological order (the most recent 200). {key} is the threadKey from /inbox/threads (URL-encode it,…

Source: https://warmerly.com/docs/inbox/get-a-thread

```text
GET /inbox/threads/{key}
```

Returns the raw messages in a single email thread, chronological order (the most recent 200). `{key}` is the `threadKey` from `/inbox/threads` (URL-encode it, thread keys are typically `Message-Id`-style strings and contain special characters).

| Query param | Required | Description |
| --- | --- | --- |
| `accountId` | **Yes** | The email account the thread is on. Missing: `400 bad_request`. An account that is not in your workspace: `404 not_found`. |

```bash
curl "https://app.warmerly.com/api/v1/inbox/threads/%3CCADx...%40mail.gmail.com%3E?accountId=8f14e45f-ceea-4c6a-8c8d-6b1a5b5c9c1a" \
  -H "X-Api-Key: wmv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
```

```json
{
  "messages": [
    {
      "id": "9d1e0b7a-5e7b-4f10-b2aa-1c8f0d3e6a4b",
      "accountId": "8f14e45f-ceea-4c6a-8c8d-6b1a5b5c9c1a",
      "folder": "INBOX",
      "threadKey": "<CADx...@mail.gmail.com>",
      "fromAddr": "jamie@northwindtraders.com",
      "fromName": "Jamie Rivera",
      "toAddrs": ["you@yourcompany.com"],
      "subject": "Re: Quick question about your workflow",
      "bodyText": "Hi, thanks for the intro, happy to learn more.",
      "isRead": true,
      "isStarred": false,
      "isArchived": false,
      "channel": "email",
      "direction": "inbound",
      "status": "sent",
      "receivedAt": "2026-06-30T11:05:00.000Z"
    }
  ]
}
```

This endpoint returns raw `inbox_messages` rows rather than the trimmed shape used by the timeline endpoint, so each message carries more fields than shown here.

## More from Inbox

- [List threads](https://warmerly.com/docs/inbox/list-threads): Returns email threads (grouped by threadKey + accountId) with aggregate counts, for building a mailbox-style…
- [Filter options](https://warmerly.com/docs/inbox/filter-options): Returns the projects and email accounts in your workspace that the inbox can be filtered by, for populating…
- [Other endpoints](https://warmerly.com/docs/inbox/other-endpoints): These cover more specialized inbox workflows and are not detailed here: