---
title: "List review campaign customers"
method: GET
path: "/locations/review-campaigns/{reviewCampaignId}/customers"
tags: ["Review Campaigns"]
---

# List review campaign customers

`GET /locations/review-campaigns/{reviewCampaignId}/customers`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/locations/review-campaigns/{reviewCampaignId}/customers`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/locations/review-campaigns/:reviewCampaignId/customers/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of customers associated with a specific review campaign, along with their response status.

**Behavior:**
- Returns customer details, including name, email/phone, and response status.
- Indicates whether a review was submitted, ignored, or pending.
- Supports filtering by response type (e.g., responded, not responded).

## Path parameters

- `reviewCampaignId` string, uuid, required

## Headers

- `Authorization` string, required

## Response `200`

Successful response

- ReviewCampaignCustomersResponse
  - `data` object
    - `reviewCampaignInfo` ReviewCampaignInfoV2
      - `campaignName` string: Name of the review campaign
      - `reviewCampaignCustomers` ReviewCampaignCustomerV2[]
        - `name` string: Customer's name
        - `phone` string: Customer's phone number
        - `email` string, email: Customer's email address
        - `rating` integer: Customer's rating
        - `response` string: Customer's feedback response
        - `date` string, date: Date of the response
        - `followUpSent` integer: Number of follow-ups sent
        - `smsDeliveredAt` string, date-time: Timestamp when SMS was delivered
        - `smsOpenedAt` string, date-time: Timestamp when SMS was opened
        - `emailDeliveredAt` string, date-time: Timestamp when email was delivered
        - `emailLastOpenedAt` string, date-time: Timestamp when email was last opened
        - `emailLastClickedAt` string, date-time: Timestamp when email was last clicked
        - `firstFollowUpAt` string, date-time: Timestamp when first follow-up was sent
        - `firstFollowUpDeliveredAt` string, date-time: Timestamp when first follow-up was delivered
        - `secondFollowUpAt` string, date-time: Timestamp when second follow-up was sent
        - `secondFollowUpDeliveredAt` string, date-time: Timestamp when second follow-up was delivered

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)
