Skip to main content
GET
List audiences
Use this endpoint to retrieve a paginated list of audiences in the workspace, with each audience’s variables, connected campaigns, and contact counts.

Endpoint

GET /audience/list Authentication: Required (workspace auth)

Query Parameters

Audience Status Codes

Deleted audiences (STATUS = 2) are always excluded from the list.

Response

Behavior

  • Results are ordered by CREATED_DATE descending.
  • An audience connected to one or more active (non-deleted) campaigns cannot be deleted — only renamed/edited.

Example cURL

Headers

token
string
required

API token for authentication

Query Parameters

page
integer

Page number (default: 1)

limit
integer

Records per page (default: 10)

Partial match against audience_name

status
enum<integer>

0=Inactive, 1=Active. Deleted audiences are always excluded.

Available options:
0,
1

Response

Audience list retrieved successfully

datalist
object[]
pagination
object