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

# GET /v1/cdp/audiences

> The account's audiences, with how many people are in each.

Every audience on the account, with how many people are in each and whether that is worked out. Rules are left out here; read one audience for its rules.

<Note>Needs the `cdp.audiences:read` scope.</Note>

## Request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.fireflo.au/v1/cdp/audiences" \
    -H "Authorization: Bearer $OMNI_API_KEY"
  ```

  ```python Python theme={null}
  import os

  import requests

  response = requests.get(
      "https://api.fireflo.au/v1/cdp/audiences",
      headers={"Authorization": f"Bearer {os.environ['OMNI_API_KEY']}"},
  )
  print(response.status_code, response.json())
  ```

  ```javascript Node theme={null}
  const response = await fetch("https://api.fireflo.au/v1/cdp/audiences", {
    headers: {
      Authorization: `Bearer ${process.env.OMNI_API_KEY}`,
    },
  });
  console.log(response.status, await response.json());
  ```
</CodeGroup>

## Response

`200 OK` — every audience, in `data`. `members` is how many are in it; `refreshed_at` is when that was last worked out.

| `status` | Meaning |
| :- | :- |
| `building` | Who's in is being worked out. `members` is what it was before. |
| `ready` | Worked out; people join and leave as they match. |
| `failed` | It couldn't be worked out: `error` says why. |

```json theme={null}
{
  "data": [
    {
      "id": "5b2e8d14-7c3a-4f9e-a1d6-3e8b0c4f2a71",
      "name": "Carts left this week",
      "description": "Added to cart in the last 7 days and didn't order",
      "status": "ready",
      "error": "",
      "members": 312,
      "refreshed_at": "2026-10-06T10:15:02+05:30",
      "created_at": "2026-09-22T11:04:37+05:30",
      "updated_at": "2026-10-01T16:20:45+05:30"
    },
    {
      "id": "e1c7a3b9-4d2f-4a8e-9c6b-7f5d3e1a0b28",
      "name": "Gold tier in Pune",
      "description": "",
      "status": "ready",
      "error": "",
      "members": 1840,
      "refreshed_at": "2026-10-06T09:58:41+05:30",
      "created_at": "2026-08-30T09:12:00+05:30",
      "updated_at": "2026-08-30T09:12:00+05:30"
    }
  ]
}
```

## Errors

Every refusal is `{"error": {"code", "message", "field"}}`; `field` is there when one input is at fault.

| Status | Error code | When |
| :- | :- | :- |
| 403 | `scope_missing` | The key doesn't have the `cdp.audiences:read` scope. |
| 404 | `module_off` | The account doesn't have Customer data on. |

Any request can also be refused for its key, its account or its rate (`key_required`, `invalid_key`, `account_suspended`, `plan_excludes_api`, `address_not_allowed`, `rate_limited`); see [the overview](/api-reference/overview).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.