> ## Documentation Index
> Fetch the complete documentation index at: https://developer.audienceful.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Audiences

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

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.

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

<Tip>To iterate through the contacts in an audience, use [List Audience Members](/api-reference/audiences/members).</Tip>

### Response

<ResponseField name="data" type="array">
  The workspace's audiences, starting with the "All active subscribers" total.

  <Expandable title="properties" defaultOpen="true">
    <ResponseField name="id" type="string">
      The audience's id. The synthetic "All active subscribers" entry uses the reserved id `"all"`.
    </ResponseField>

    <ResponseField name="name" type="string">
      The audience's name.
    </ResponseField>

    <ResponseField name="members" type="number">
      The number of contacts in the audience.
    </ResponseField>

    <ResponseField name="created_at" type="string or null">
      The datetime (UTC) the audience was created. `null` for the "All active subscribers" entry.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request GET 'https://api.audienceful.com/v2/audiences' \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <your-api-key>'
  ```

  ```python Python theme={null}
  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())
  ```

  ```javascript JavaScript theme={null}
  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);
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "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"
      }
    ]
  }
  ```
</ResponseExample>