v1

latestOpenAPI 3.1.02026-07-2419603.1 MB
Data Activation

List audiences

List Audiences. Requires view permission.

get/api/cdp/settings/v1/app/{app_id}/audience

Path parameters

app_idstring uuid required

ID of the app.

Example:3929d56c-cd62-4001-a4fc-013f5f954691

Response

OK

idstring uuid required

ID of the audience

app_idstring uuid required

ID of the app

created_atstring date-time required

Audience creation date

updated_atstring date-time required

Latest audience update date

namestring required

Name of the audience

descriptionstring required

Description of the audience

membership_duration_daysinteger required

Time (in days) after which profiles are removed from an audience

type'standard' | 'sequential' required
is_authorboolean required

Whether the audience was created by the user who issues the request

versioninteger required

Version number, incremented on every update of definition or membership_duration_days

Example response

[
  {
    "author": {
      "email": "author@piwik.pro"
    }
  }
]