---
title: "Get the message thread with a creator"
method: GET
path: "/creator-messages/conversations/{creator_handle}/messages"
tags: ["Creator Messages"]
---

# Get the message thread with a creator

`GET /creator-messages/conversations/{creator_handle}/messages`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/creator-messages/conversations/{creator_handle}/messages`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

## Path parameters

- `creator_handle` string, required

## Query parameters

- `page` integer

## Response `200`

Successful Response

- CreatorMessagesResponse
  - `creator_handle` string, required
  - `data` CreatorMessageItem[], required
    - `id` integer, required
    - `sender` string, required: 'creator' (inbound) or 'shop' (outbound).
    - `content_type` string, required
    - `text` string, nullable
    - `sent_at` string, nullable
    - `sent_via` string, nullable: For shop messages sent through Reacher: 'inbox' (a person in the Reacher inbox), 'api' (a Public API key) or 'mcp' (an agent through the MCP connector). Null for creator messages and history synced from TikTok.
    - `image` ImageContent: Image-specific content fields.
      - `url` string, required
      - `width` integer, nullable
      - `height` integer, nullable
    - `product_card` ProductCardContent: Product card-specific content fields.
      - `product_id` string, required
      - `product_name` string, nullable
      - `image_url` string, nullable
    - `target_collaboration_card` TargetCollaborationCardContent: Target collaboration card-specific content fields.
      - `invitation_group_id` string, required
    - `free_sample_card` FreeSampleCardContent: Free sample card-specific content fields.
      - `apply_id` string, required
    - `crm_text_with_image_card` CrmTextWithImageCardContent: CRM text with image card content fields.
      - `title` string, nullable
      - `content` string, nullable
      - `url` string, nullable
    - `crm_text_with_products_card` CrmTextWithProductsCardContent: CRM text with products card content fields.
      - `title` string, nullable
      - `content` string, nullable
      - `products` CrmProductCardItem[], nullable
        - `product_id` string, required
        - `product_name` string, nullable
        - `image_url` string, nullable
  - `page` integer, required
  - `has_more` boolean, required
  - `pagination` PublicApiCorePaginationPaginationMeta: Pagination metadata returned in responses.
    - `total_count` integer, required
    - `page` integer, required
    - `page_size` integer, required
    - `total_pages` integer, required
  - `page_size` integer: Messages per page (fixed at 20 on this surface).
  - `total_count` integer: Total messages in the conversation thread.
  - `total_pages` integer: Total pages available.
  - `has_previous` boolean: True when `page` > 1 and there is data.

## Other responses

- `422`: Validation Error

## Changes

> 76 revisions in range; 1 not diffed.

- **2026-09-19** `291230805105`: 2 info
  - api operation id `get_conversation_messages_creator_messages_conversations__creator_handle__messages_get` removed and replaced with `creator_messages_conversation_messages`
  - added the optional property `pagination` to the response with the `200` status
- **2026-09-10** `7dad11366a32`: 1 info
  - added the optional property `data/items/sent_via` to the response with the `200` status

[Operation history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/creator-messages/conversations/:creator_handle/messages/get.md)

---

[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.dev/reacherapp/apis/reacher-data-api/revisions/63ce74b30b5a?raw)