Ads API •References / audiences / List Audiences accessible to an Ad Account

List Audiences accessible to an Ad Account

Returns a list of audiences accessible to the ad account.

Request

ad_account_id
string [uuid]
Required
A unique identifier for an Ad Account.
Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
audience_ids
array of strings
A unique identifier for the entity.
Example: audience_ids=ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
audience_types
array of strings
Type of the audience.
Default: audience_types=CUSTOMAllowed values: "CUSTOM", "LOOKALIKE"
q
string
Query to search by keyword via case-insensitive wildcard matching.
Example: q=query
limit
integer
Limit or page size for a given response.
Default: limit=50Range: 1 - 50Example: limit=50
offset
integer
Starting position of the next record to assist in data pagination.
Default: offset=0Example: offset=0
sort_direction
string
Field by which to order the results of the query.
Default: sort_direction=DESCAllowed values: "ASC", "DESC"Example: sort_direction=ASC
sort_field
string
Default: sort_field=UPDATED_ATAllowed values: "NAME", "UPDATED_AT"

Response

A list of audiences.

- page_size
  integer [int32]
- total_results
  integer [int32]
- offset
  integer [int32]
- current_page
  integer [int32]
- created_at
  string [date-time]
  Date the entity was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
  Example: "2026-01-23T04:56:07Z"
- updated_at
  string [date-time]
  Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
  Example: "2026-01-23T04:56:07Z"
- id
  string [uuid]
  A unique identifier for the entity.
  Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- name
  string
  Name of the audience.
  Length between 2 and 80Example: "US - 18-24 - All gender"
- description
  string
  Description of the audience.
  Maximum length: 80Example: "For spring promotion campaign"
- type
  string
  Type of the audience.
  Default: "CUSTOM"Allowed values: "CUSTOM", "LOOKALIKE"
- An approximate range of users in the audience.
  min
  integer
  Minimum of an approximate range of users in the audience.
  Minimum value: 0
  max
  integer
  Maximum of an approximate range of users in the audience.
  Minimum value: 0
- status
  string
  Status of the audience.
  Default: "PROCESSING"Allowed values: "ARCHIVED", "PROCESSING", "EMPTY", "LEARNING", "BOOKABLE", "LIVE"
- sources
  array of strings
  Sources of the audience data.
  Source of the audience data.
  Default: "UNKNOWN"Allowed values: "UNKNOWN", "CUSTOMER_LIST", "AUDIENCE", "PIXEL", "CONVERSIONS_API"
- seed_audience_id
  string [uuid]
  ID of the seed audience for the lookalike audience.
  Supported content-type(s): Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- seed_audience_name
  string
  Name of the audience.
  Length between 2 and 80Example: "US - 18-24 - All gender"
- lookalike_audience_ids
  array of strings
  IDs of the lookalike audiences created from the current audience.
  A unique identifier for the entity.
  Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- Datasets associated with the web event custom audience.
  id
  string [uuid]
  A unique identifier for the entity.
  Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  name
  string
  The name of the dataset.
- included_events
  array of strings
  Event names included in the web event custom audience.
  Example: "ADDTOCART"
- excluded_events
  array of strings
  Event names excluded from the web event custom audience.
  Example: "PURCHASE"
- lookback_days
  integer
  Lookback window for events in the web event custom audience.
  Example: 30

Response sample

{  "paging": {    "page_size": 0,    "total_results": 0,    "offset": 0,    "current_page": 0  },  "audiences": [    {      "created_at": "2026-01-23T04:56:07Z",      "updated_at": "2026-01-23T04:56:07Z",      "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "name": "US - 18-24 - All gender",      "description": "For spring promotion campaign",      "type": "CUSTOM",      "size": {        "min": 0,        "max": 0      },      "status": "PROCESSING",      "sources": ["UNKNOWN"],      "seed_audience_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "seed_audience_name": "US - 18-24 - All gender",      "lookalike_audience_ids": ["ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"],      "datasets": [        {          "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",          "name": "string"        }      ],      "included_events": ["ADDTOCART"],      "excluded_events": ["PURCHASE"],      "lookback_days": 30    }  ]}