---
title: "List conversations"
method: GET
path: "/api/v1/messages"
---

# List conversations

`GET /api/v1/messages`

## Request

- Base URL: `https://traydstar.com`
- URL: `https://traydstar.com/api/v1/messages`
- Auth: HTTP bearer

Scope: read. One conversation per other Trayder, newest first, with unread count and the last message.

## Response `200`

{ conversations: [{ with_user_id, with_display_name, unread, last_message }] }

- object
  - `conversations` Conversation[], required
    - `with_user_id` string, uuid
    - `with_display_name` string
    - `unread` number
    - `last_message` Message
      - `id` string, uuid
      - `from_user_id` string, uuid
      - `to_user_id` string, uuid
      - `mine` boolean
      - `sent_by_agent` boolean
      - `listing_id` string, uuid, nullable
      - `content` string
      - `attachment` object, nullable
      - `read` boolean
      - `created_at` string, date-time

## Other responses

- `default`: Error.

---

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