---
title: "List feedback responses"
method: GET
path: "/feedbackResponses"
tags: ["feedbackResponses"]
---

# List feedback responses

`GET /feedbackResponses`

## Request

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

Returns patient responses to NPS feedback surveys, along with clicks on the
positive/negative feedback links sent after an appointment.

Read-only: feedback responses are recorded by the NPS survey / feedback-link flow,
not created or edited through the API.

`response.type` is one of:
  - `npsscore`: the patient submitted a numeric NPS score (`response.value` is the score,
    also copied to `npsscore` for convenience).
  - `positive-click` / `negative-click`: the patient clicked the positive or negative link
    sent in the feedback message, before any score was collected.

## Query parameters

- `patient` string
- `provider` string
- `facility` string
- `appointment` string
- `response.type` 'npsscore' | 'positive-click' | 'negative-click'
- `user` string
- `deleted` 0 | 1
- `createdBy` string
- `updatedBy` string
- `createdAt` string, date-time
- `updatedAt` string, date-time
- `page` integer
- `limit` integer
- `_populate` string
- `_select` string

## Response `200`

A list of feedback responses

- object
  - `response` object[]
    - `_id` string
    - `patient` string: Patient ID
    - `provider` string: Provider ID
    - `facility` string: Facility ID
    - `appointment` string: Appointment ID
    - `npsscore` number: Copy of response.value when response.type is npsscore
    - `response` object
      - `type` 'npsscore' | 'positive-click' | 'negative-click'
      - `value` unknown
    - `scoreSource` 'patient' | 'sentiment': Only set when response.type is npsscore
  - `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

[Operation history](https://skmtc.dev/lumahealth/apis/rest-service/changes/feedbackResponses/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)