---
title: "Get a conversation thread"
method: GET
path: "/mailboxes/{address}/messages/{uid}/thread"
tags: ["Mail"]
---

# Get a conversation thread

`GET /mailboxes/{address}/messages/{uid}/thread`

## Request

- Base URL: `https://faivelo.com/api/v1`
- URL: `https://faivelo.com/api/v1/mailboxes/{address}/messages/{uid}/thread`
- Auth: HTTP bearer

Reconstructs the whole conversation a message belongs to (from its Message-ID and References headers), including the mailbox's own replies in Sent, oldest first. Covers the most recent 200 messages per folder. Takes the numeric UID only. Requires scope `mail:read`.

## Path parameters

- `address` string, required
- `uid` integer, required

## Query parameters

- `folder` string

## Response `200`

The thread

- object
  - `success` boolean
  - `data` Thread
    - `root` string: Message-ID of the first message in the conversation
    - `messages` object[]: Oldest first. Use the message endpoint with `uid` and `folder` for a full body.
      - `uid` integer
      - `folder` string
      - `from` string
      - `subject` string
      - `date` string, date-time
      - `seen` boolean
      - `messageId` string

## Other responses

- `401`: Missing or invalid API key
- `402`: The account's plan does not include the API (`plan_required`)
- `403`: The key lacks the required scope
- `404`: Resource not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/faivelo/apis/faivelo-api.md) · [All operations](https://skmtc.dev/faivelo/apis/faivelo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faivelo/apis/faivelo-api/revisions/a7413ddea5d1?raw)