List Audiences

Returns your workspace's audiences and the number of contacts in each.

GEThttps://api.audienceful.com/v2/audiences

curl --location --request GET 'https://api.audienceful.com/v2/audiences' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <your-api-key>'

{
  "data": [
    {
      "id": "all",
      "name": "All active subscribers",
      "members": 12840,
      "created_at": null
    },
    {
      "id": "jQKdwqp3YRRtTrwqUJEp7d",
      "name": "Engaged users",
      "members": 3204,
      "created_at": "2026-07-04T12:00:00Z"
    },
    {
      "id": "o4i4TNZnWsq2f2ZWVqNNWY",
      "name": "New signups",
      "members": 512,
      "created_at": "2026-07-04T12:00:00Z"
    }
  ]
}

Requires the audiences:read scope. Returns every audience in the workspace along with its member count.

The response always leads with a synthetic "All active subscribers" entry (id: "all") whose members is the total number of active subscribers in the workspace, followed by your saved audiences ordered by member count (largest first). One-time send audiences are excluded, matching the audience list in the app.

Audiences are a small, plan-limited set, so this endpoint returns them all in one response — it is not cursor-paginated.

To iterate through the contacts in an audience, use List Audience Members.

Response

dataarray

The workspace's audiences, starting with the "All active subscribers" total.

Properties

idstring

The audience's id. The synthetic "All active subscribers" entry uses the reserved id "all".

namestring

The audience's name.

membersnumber

The number of contacts in the audience.

created_atstring or null

The datetime (UTC) the audience was created. null for the "All active subscribers" entry.