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.

Needs the cdp.audiences:read scope.

Request

cURL

curl "https://api.fireflo.au/v1/cdp/audiences" \
  -H "Authorization: Bearer $OMNI_API_KEY"

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.

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