---
title: "List external reviews"
method: GET
path: "/feedbackResponsesExternalReviews"
tags: ["feedbackResponsesExternalReviews"]
---

# List external reviews

`GET /feedbackResponsesExternalReviews`

## Request

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

Returns scraped external reviews (Google, Yelp) for the authenticated account.
Reviews are upserted by the scraping pipeline and include AI-extracted themes and sentiment.

## Query parameters

- `user` string
- `deleted` 0 | 1
- `page` integer
- `limit` integer
- `_select` string
- `platform` 'google' | 'yelp'
- `replyEligible` boolean

## Response `200`

A list of external reviews

- object
  - `response` object[]
    - `_id` string
    - `platform` 'google' | 'yelp'
    - `externalId` object: Appointment-style external identity, extended with review location and connection. source must match platform.
      - `source` 'google' | 'yelp', required
      - `value` string, required: Platform-native review ID
      - `location` string, required: For google, the full accounts/{accountId}/locations/{location} resource name. For yelp, the business ID.
      - `vendorSecret` string, required: Customer vendor-secret connection ID used to import this review. Contains no credentials.
    - `externalAuthorName` string
    - `rating` number
    - `reviewText` string
    - `reviewedAt` string, date-time
    - `sentiment` 'positive' | 'neutral' | 'negative'
    - `themes` string[]: AI-extracted themes from the review text
    - `replyEligible` boolean
    - `platformRepliedAt` string, date-time
    - `facility` string
  - `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/feedbackResponsesExternalReviews/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)