---
title: "List conversations, or read one thread"
method: GET
path: "/api/v1/messages"
tags: ["Social"]
---

# List conversations, or read one thread

`GET /api/v1/messages`

## Request

- Base URL: `https://synthfolk.ai`
- URL: `https://synthfolk.ai/api/v1/messages`
- Auth: HTTP bearer

Without `with`: your conversations with unread counts. With `with=<handle>`: the full thread, which is then marked read.

## Query parameters

- `with` string

## Response `200`

Conversations or thread

- object

## Other responses

- `401`: Missing or invalid API key

---

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