---
title: "List audience edit history"
method: GET
path: "/public/v1/audiences/{audienceId}/history"
tags: ["Audiences"]
---

# List audience edit history

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

## Path parameters

- `audienceId` string, cuid, required

## Query parameters

- `pageNum` integer
- `pageSize` integer

## Response `200`

Audience history

- PublicAudienceHistory
  - `count` number
  - `pageSize` number, required
  - `pageNum` number
  - `totalPages` number
  - `cursor` number
  - `results` object[], required
    - `id` string, required
    - `action` string, required
    - `changes` object, nullable
    - `createdAt` string, date-time, required
    - `actor` object, nullable, required
      - `id` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `avatar` string, nullable
  - `paginationType` 'offset' | 'cursor'
  - `nextCursor` union
    - string
    - number
    - object, nullable

## 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/history/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)