---
title: "List a creator's CRM status transitions"
method: GET
path: "/crm/creators/{creator_id}/history"
tags: ["CRM Roster"]
---

# List a creator's CRM status transitions

`GET /crm/creators/{creator_id}/history`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/crm/creators/{creator_id}/history`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

The audit log of lifecycle changes for one creator on this shop, from `customers.crm_creator_status_history` — each row is a `previous_status` → `new_status` move with the timestamp the sync detected it, plus display labels for both. Use it to measure how long creators sit in a stage, or to reconstruct when a sample was approved, shipped or went unfulfilled.

The grain is (creator, product): a creator collaborating on three products has three independent transition chains, so filter by `product_id` to follow one. Ordered newest first.

Single-shop only. Creator contact details are never returned: no real name, shipping address, phone or email. `creator_name` is the public TikTok handle.

## Path parameters

- `creator_id` string, required: Creator id from GET /crm/creators.

## Query parameters

- `product_id` string, nullable: Restrict to one product's chain.
- `page` integer: 1-based page number.
- `page_size` integer: Transitions per page (max 200).

## Response `200`

Successful Response

- CrmStatusHistoryResponse
  - `data` CrmStatusTransition[], required
    - `product_id` string, nullable
    - `previous_status` string, nullable
    - `previous_status_label` string, nullable
    - `new_status` string, nullable
    - `new_status_label` string, nullable
    - `transition_detected_at` string, date-time, nullable
  - `pagination` PublicApiCorePaginationPaginationMeta, required: Pagination metadata returned in responses.
    - `total_count` integer, required
    - `page` integer, required
    - `page_size` integer, required
    - `total_pages` integer, required

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