---
title: "Preview audience members"
method: GET
path: "/public/v1/audiences/{audienceId}/preview"
tags: ["Audiences"]
---

# Preview audience members

`GET /public/v1/audiences/{audienceId}/preview`

## Path parameters

- `audienceId` string, cuid, required

## Query parameters

- `pageNum` integer
- `pageSize` integer

## Response `200`

Audience preview

- PublicAudiencePreview
  - `count` number
  - `pageSize` number, required
  - `pageNum` number
  - `totalPages` number
  - `cursor` number
  - `results` object[], required
    - `peopleId` string, required
    - `people` object, required
    - `sources` string[], required
  - `paginationType` 'offset' | 'cursor'
  - `nextCursor` union
    - string
    - number
    - object, nullable
  - `recordTypes` union, required
    - integer[]
    - 'all'
  - `truncated` boolean, required
  - `resolution` object
    - `id` string, required
    - `revision` integer, required
    - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'STALE' | 'CANCELLED', required
    - `processedCount` integer, required
    - `totalCount` integer, required
    - `nextCursor` string, nullable, required
    - `error` string, nullable
  - `composition` object
    - `includedPeople` integer, required
    - `excludedPeople` integer, required
    - `duplicateRows` integer, required
    - `rejectedRows` integer, required
    - `effectivePeople` integer, required

## Other responses

- `400` — Invalid request
- `401` — A USER API key is required
- `403` — Insufficient campaign or audience permission
- `404` — Resource not found

## Changes

- **2026-10-03** `666cd9efa9f3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/getfrontline/apis/public-api/changes/public/v1/audiences/:audienceId/preview/get.md)

---

[API](https://skmtc.dev/getfrontline/apis/public-api.md) · [All operations](https://skmtc.dev/getfrontline/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getfrontline/apis/public-api/revisions/666cd9efa9f3?raw)