---
title: "List creator conversations"
method: GET
path: "/creator-messages/conversations"
tags: ["Creator Messages"]
---

# List creator conversations

`GET /creator-messages/conversations`

The shop's creator DM inbox. Use `unreplied_only=true` to get conversations awaiting a reply (what an AI agent typically iterates).

## Query parameters

- `offset` integer
- `limit` integer
- `unread_only` boolean
- `unreplied_only` boolean

## Response `200`

Successful Response

- CreatorConversationsResponse
  - `data` CreatorConversationItem[], required
    - `creator_handle` string, nullable — Creator username (no leading @).
    - `last_message_text` string, nullable
    - `last_message_time` string, nullable
    - `last_message_sender` string, nullable — 'creator' or 'shop'.
    - `unread_count` integer
  - `offset` integer, required
  - `limit` integer, required
  - `has_more` boolean, required
  - `total_count` integer, required
  - `unread_conversations` integer — Number of conversations with at least one unread message (NOT the number of unread messages — see /creator-messages/stats `unread_messages` for that). Independent of the unread_only filter.
  - `unreplied_conversations` integer — Number of conversations whose last message came from the creator (awaiting a shop reply). Independent of the unreplied_only filter.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) · [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/reacherapp/reacher-data-api/revisions/d4fe3e380424/schema)