---
title: "List audiences"
method: GET
path: "/api/cdp/settings/v1/app/{app_id}/audience"
tags: ["Data Activation"]
---

# List audiences

`GET /api/cdp/settings/v1/app/{app_id}/audience`

List Audiences. Requires view permission.

## Path parameters

- `app_id` string, uuid, required — ID of the app.

## Response `200`

OK

- object[]
  - `id` string, uuid, required — ID of the audience
  - `app_id` string, uuid, required — ID of the app
  - `created_at` string, date-time, required — Audience creation date
  - `updated_at` string, date-time, required — Latest audience update date
  - `name` string, required — Name of the audience
  - `description` string, required — Description of the audience
  - `membership_duration_days` integer, required — Time (in days) after which profiles are removed from an audience
  - `wait` union, required — How long to wait after profile matches conditions before adding it to the audience
    - object
      - `seconds` integer, required
    - object
      - `minutes` integer, required
    - object
      - `hours` integer, required
    - object
      - `days` integer, required
  - `type` 'standard' | 'sequential', required
  - `author` object, required — Author of an audience
    - `email` string, email, required — Email (login) of an author
  - `is_author` boolean, required — Whether the audience was created by the user who issues the request
  - `version` integer, required — Version number, incremented on every update of definition or membership_duration_days

## Other responses

- `400` — Bad request response (e.g. missing GET parameter, parameter value out of bounds)
- `401` — Access token is missing or invalid
- `402` — Data Activation module is disabled
- `404` — Resource not found (bad ID or resource deleted)
- `500` — Internal application error response (some service encountered unexpected error)

---

[API](https://skmtc.net/piwik/apis/web-api.md) · [All operations](https://skmtc.net/piwik/apis/web-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/piwik/web-api/versions/f63416a36168/schema)