---
title: "List promoter platform histories"
method: GET
path: "/feedbackResponsesPromoterHistories"
tags: ["feedbackResponsesPromoterHistories"]
---

# List promoter platform histories

`GET /feedbackResponsesPromoterHistories`

## Request

- Base URL: `https://api.lumahealth.io/api/v2`
- URL: `https://api.lumahealth.io/api/v2/feedbackResponsesPromoterHistories`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lumahealth/apis/rest-service/docs/feedbackResponsesPromoterHistories/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns per-patient records tracking which review platforms a promoter (NPS ≥ 9) has
been directed to. Used internally to rotate patients across configured platforms so no
single platform receives all reviews.

One document per patient per account. `platformsAsked` grows with each feedback send;
once all configured platforms are exhausted the history is cleared and rotation restarts.

## Query parameters

- `user` string
- `deleted` 0 | 1
- `page` integer
- `limit` integer
- `_select` string
- `patient` string

## Response `200`

A list of promoter history records

- object
  - `response` object[]
    - `_id` string
    - `patient` string: Patient ID
    - `platformsAsked` string[]: Ordered list of platforms this patient has been directed to
    - `lastPlatformAsked` 'google' | 'yelp'
    - `lastAskedAt` string, date-time
  - `page` integer
  - `size` integer

## Other responses

- `401`: Not authenticated
- `403`: Not authorized
- `500`: Internal server error

## Changes

- **2026-10-17** `f19aeba84a26`: 1 info
  - endpoint added
- **2026-08-23** `d3c75c2a2f1d`: 1 breaking
  - api path removed without deprecation
- **2026-08-14** `3d7b2678a2ff`: 1 info
  - endpoint added
- **2026-08-11** `7f2513842cf4`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/lumahealth/apis/rest-service/changes/feedbackResponsesPromoterHistories/get.md)

---

[API](https://skmtc.dev/lumahealth/apis/rest-service.md) - [All operations](https://skmtc.dev/lumahealth/apis/rest-service/llms.txt) - [OpenAPI document](https://skmtc.dev/lumahealth/apis/rest-service/revisions/f19aeba84a26?raw)