---
title: "Changes to Get the list of audiences."
method: GET
path: "/api/external/v1/audiences/get-list"
---

# Changes to Get the list of audiences.

`GET /api/external/v1/audiences/get-list`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 4 revisions.

- **2026-08-17** `dd3f47f72f7a`: 3 breaking, 1 warning, 1 info

## Changes

- **2026-08-17** `dd3f47f72f7a`: 3 breaking, 1 warning, 1 info
  - added the new required `query` request parameter `workspace_id`
  - removed the request body
  - the response's body type changed from `object` to `array` for status `200`
  - removed the optional property `audiences` from the response with the `200` status
  - added the non-success response with the status `403`

---

[Operation](https://skmtc.dev/genpage/apis/genpage-external-api-documentation/docs/api/external/v1/audiences/get-list/get.md) - [API](https://skmtc.dev/genpage/apis/genpage-external-api-documentation.md) - [Page](https://skmtc.dev/genpage/apis/genpage-external-api-documentation/changes/api/external/v1/audiences/get-list/get)