List Audiences

1 min

GET

https://api.optimizely.com/v2/audiences

List Audiences for a Project

Query Parameters

per_pageinteger
Description
Optional pagination argument that specifies the maximum number of objects to return per request
Default
25
Maximum
100
pageinteger
Description
Optional pagination argument that specifies the page to return. If you have 140 objects and you choose to return 100 objects per page you will be able to access the last 40 objects on page 2. The default value is 1.
Default
1
project_idinteger<int64>required
Description
The Project ID of the Project you would like to list all Audiences for
Format
int64
for_journeyboolean
Description
Filter audiences by journey status
archivedboolean
Description
Filter audiences by archived status

Responses

200Return all Audiences

Audience[]
- archivedboolean
  Description
  Whether the Audience has been archived
  Default
  false
- conditionsstring
  Example
```
[
  "and",
  {
    "type": "language",
    "value": "es"
  },
  {
    "type": "location",
    "value": "US-CA-SANFRANCISCO"
  }
]
```
  Description
  A string defining the targeting rules for an Audience
- createdstring<date-time>
  Description
  The time the Audience was initially created
  Format
  date-time
- descriptionstring
  Example
  People that speak spanish and are in San Francisco
  Description
  A short description of the Audience
- experiment_countinteger<int64>
  Example
  123
  Description
  Number of experiments by audience_id
  Format
  int64
- for_journeyboolean
  Description
  Whether the Audience has been part of journey or not
  Default
  false
- idinteger<int64>
  Example
  5000
  Description
  The unique identifier for the Audience
  Format
  int64
- is_classicboolean
  Description
  Whether or not Audience is a classic Audience. If true, the Audience is only compatible with classic Experiments. Otherwise, the Audience may be used in Optimizely X Campaigns.
- last_modifiedstring<date-time>
  Description
  The last time the Audience was modified
  Format
  date-time
- namestring
  Example
  Spanish speaking San Franciscans
  Description
  The name of the Audience
- project_idinteger<int64>required
  Example
  1000
  Description
  The ID of the Project the Audience was created in
  Format
  int64
- segmentationboolean
  Description
  True if the Audience is available for segmentation on the results page (Audiences can only be used for segmentation in Optimizely Classic). Set to False if you intend to use this Audience only in Optimizely X. Note that a maximum of 10 Audiences can have segmentation set to True in any given Optimizely Classic project.
  Default
  false

401Invalid credentials

Error
- codestring
- messagestring
- messagesobject
- uuidstring<uuid>
  Format
  uuid

403You do not have access to Audiences under the specified Project

Error
- codestring
- messagestring
- messagesobject
- uuidstring<uuid>
  Format
  uuid

404Project not found

Error
- codestring
- messagestring
- messagesobject
- uuidstring<uuid>
  Format
  uuid

defaultUnexpected error

Error
- codestring
- messagestring
- messagesobject
- uuidstring<uuid>
  Format
  uuid

curl

curl --request GET \
     --url 'https://api.optimizely.com/v2/audiences?per_page=25&page=1&project_id=integer%3Cint64%3E' \
     --header 'accept: application/json'

javascript

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");

var requestOptions = {
   method: 'GET',
   headers: myHeaders,
   redirect: 'follow'
};

fetch("https://api.optimizely.com/v2/audiences?per_page=25&page=1&project_id=integer<int64>", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

ruby

require "uri"
require "json"
require "net/http"

url = URI("https://api.optimizely.com/v2/audiences?per_page=25&page=1&project_id=integer<int64>")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"

response = https.request(request)
puts response.read_body

python

import requests
import json

url = "https://api.optimizely.com/v2/audiences?per_page=25&page=1&project_id=integer<int64>"

payload = {}
headers = {
   'accept': 'application/json',
   'content-type': 'application/json'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

200

// Return all Audiences
[
  {
    "archived": false,
    "conditions": "[\"and\", {\"type\": \"language\", \"value\": \"es\"}, {\"type\": \"location\", \"value\": \"US-CA-SANFRANCISCO\"}]",
    "created": "",
    "description": "People that speak spanish and are in San Francisco",
    "experiment_count": 123,
    "for_journey": false,
    "id": 5000,
    "is_classic": false,
    "last_modified": "",
    "name": "Spanish speaking San Franciscans",
    "project_id": 1000,
    "segmentation": false
  }
]

401

// Invalid credentials
{
  "code": "",
  "message": "",
  "messages": {},
  "uuid": ""
}

403

// You do not have access to Audiences under the specified Project
{
  "code": "",
  "message": "",
  "messages": {},
  "uuid": ""
}

404

// Project not found
{
  "code": "",
  "message": "",
  "messages": {},
  "uuid": ""
}

default

// Unexpected error
{
  "code": "",
  "message": "",
  "messages": {},
  "uuid": ""
}