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

import requests

url = "https://api.audienceful.com/v2/audiences"
headers = {
    "Content-Type": "application/json",
    "X-Api-Key": "<your-api-key>",
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://api.audienceful.com/v2/audiences", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": "<your-api-key>",
  },
});
const data = await response.json();
console.log(data);

{
  "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

​
data
array
The workspace’s audiences, starting with the “All active subscribers” total.
curl --location --request GET 'https://api.audienceful.com/v2/audiences' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <your-api-key>'

import requests

url = "https://api.audienceful.com/v2/audiences"
headers = {
    "Content-Type": "application/json",
    "X-Api-Key": "<your-api-key>",
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://api.audienceful.com/v2/audiences", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": "<your-api-key>",
  },
});
const data = await response.json();
console.log(data);

{
  "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"
    }
  ]
}