List Campaigns

1 min

GET

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

Get a list of all the Campaigns in 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 Campaigns for
Format
int64
for_journeyboolean
Description
Filter campaigns by journey status
archivedboolean
Description
Filter campaigns by archived status

Responses

200Return all Campaigns

Campaign[]
- archivedboolean
  Description
  Whether the Campaign has been archived
  Default
  false
- changesSharedCodeChange[]
  Description
  A list of changes to apply to the Campaign. This corresponds to the Campaign's Shared Code in the application. Only supports 'custom_css' or 'custom_code' type changes.
  - asyncboolean
    Description
    Indicates whether or not to execute the change asyncronously. If true, src will be returned in the response. Otherwise, it will be not included.
  - dependenciesstring[]
    Example
    [ "993fd09c-b64a-4c13-95a9-13b3ed2c454e", "95cf0144-fb63-431d-829b-193fe55ada18" ]
    Description
    A list of dependent change IDs that must happen before this change
  - idstring<uuid>
    Description
    The ID of the change
    Format
    uuid
  - namestring
    Example
    Setting button text
    Description
    Name of the change
  - selectorstring
    Example
    head
    Description
    CSS selector to determine where changes are applied. Required for changes of type 'custom_css'.
  - srcstring
    Description
    The path to the change payload on the CDN. Only present if 'async' is True.
  - typestring<custom_code | custom_css>required
    Description
    The type of this change.
    Allowed
    custom_codecustom_css
  - valuestringrequired
    Example
    window.someGlobalFunction();
    Description
    The value for the change can be JavaScript or CSS as a string.
- createdstring<date-time>
  Description
  The time the Campaign was initially created
  Format
  date-time
- custom_field_valuesmap<string, string>
  Description
  Map of custom field api_name to value for this Campaign. Keys correspond to the api_name of a custom field definition for the Project, and values are typed according to that definition's field_type. Returns an empty object when no values are set.
- descriptionstring
  Example
  Tailor the landing page hero element for specific audiences
  Description
  The description or goal for a Campaign
- earlieststring<date-time>
  Description
  The first time the Campaign was activated
  Format
  date-time
- experiment_prioritiesarray[]
  Description
  A list of lists of Experiment IDs that indicate the relative priority of how to show those Experiments in the context of the Campaign. Each list inside of the list represents a group of Experiments of equal priority where groups that appear earlier in the list are of higher priority to be shown.
- for_journeyboolean
  Description
  Whether the Campaign has been part of journey or not
  Default
  false
- holdbackinteger
  Example
  500
  Description
  Percentage of visitors to exclude from personalization, measured in basis points. 100 basis points = 1% traffic. For example, a value of 500 would mean that 95% of visitors will see a personalized experience and 5% will see the holdback.
  Minimum
  0
  Maximum
  10000
- idinteger<int64>
  Example
  2000
  Description
  The unique identifier for the Campaign
  Format
  int64
- journey_idstring
  Description
  The journey this campaign is associated with, or null if not set
- last_modifiedstring<date-time>
  Description
  The last time the Campaign was modified
  Format
  date-time
- lateststring<date-time>
  Description
  The last time the Campaign was paused (not present if the Campaign still running)
  Format
  date-time
- metricsMetric[]
  Description
  An ordered list of metrics to track for the Campaign
  - aggregatorstring<unique | count | sum | bounce | exit | ratio>
    Description
    The aggregation function for the numerator of the metric. 'unique' measures the number of unique visitors/sessions that include the specified Event. 'count' measures the total number of occurrences of Event for the scope (visitor/session). 'sum' is the sum of the 'field' value
    Allowed
    uniquecountsumbounceexitratio
  - display_titlestring
    Description
    Display title for the metric
  - event_idinteger<int64>
    Description
    The ID for the Event to select data from. Omitted for global metrics that are not relative to a specific Event, i.e. "overall revenue"
    Format
    int64
  - event_propertiesMetricEventProperties
    Description
    The conditions used to filter the metric on specific event property values.
    - filterMetricFilter
      Description
      The set of event property conditions a conversion must match to be counted toward the metric.
      - combine_operatorstring<and | or>
        Description
        Determines whether all conditions (and) or any condition (or) must be met.
        Allowed
        andor
      - conditionsMetricFilterCondition[]
        Description
        defines the event property values and operator used to check whether the conversion meets the condition.
        namestring
        Description
        The name of the event property to match to.
        operatorstring<equal_to | not_equal_to | greater_than | greater_than_or_equal_to | less_than | less_than_or_equal_to | contains | does_not_contain>
        Description
        The type of match to be performed. equal_to and not_equal_to are available for all property types. greater_than, greater_than_or_equal_to, less_than, and less_than_or_equal_to are only available for properties with type number. contains and does_not_contain are only available for properties with type string.
        Allowed
        equal_tonot_equal_togreater_thangreater_than_or_equal_toless_thanless_than_or_equal_tocontainsdoes_not_contain
        typestring<boolean | number | string>
        Description
        The data type of the event property.
        Allowed
        booleannumberstring
        valuestring
        Description
        The value the conversion's property should match, according to the operator.
  - fieldstring<revenue | value>
    Description
    The field to aggregate for the numerator of the metric. Required when 'aggregator' = 'sum', otherwise omitted
    Allowed
    revenuevalue
  - metricsCompoundSubMetric[]
    Description
    A list of all metrics that will be used in the calculation of a ratio metric.
    - aggregatorstring<unique | count | sum>
      Description
      The aggregation function for the numerator of the metric. 'unique' measures the number of unique visitors/sessions that include the specified Event. 'count' measures the total number of occurrences of Event for the scope (visitor/session). 'sum' is the sum of the 'field' value.
      Default
      unique
      Allowed
      uniquecountsum
    - event_idinteger<int64>
      Description
      The ID for the Event to select data from.
      Format
      int64
    - event_typestring<custom | click | pageview>
      Description
      The type of this Event.
      Allowed
      customclickpageview
    - fieldstring<revenue | value>
      Description
      The field to aggregate for the numerator of the metric. Required when 'aggregator' = 'sum', otherwise omitted.
      Allowed
      revenuevalue
    - scopestring<session | visitor | event>
      Description
      Specifies how Events should be grouped. Can also be thought of as the denominator of the metric. 'session' divides by the number of sessions. "Influenced sessions", or sessions that do not contain a decision Event but carry a decision from a previous session are not included in counts for numerator or denominator. 'visitor' divides by the number of visitors. 'event' divides by the total occurrences (impressions) of the specified Event.
      Default
      visitor
      Allowed
      sessionvisitorevent
  - scopestring<session | visitor | event>
    Description
    Specifies how Events should be grouped together. Can also be thought of as the denonimator of the metric. 'session' divides by the number of sessions. "Influenced sessions", or sessions that do not contain a decision Event but carry a decision from a previous session are not included in counts for numerator or denominator. 'visitor' divides by the number of visitors. 'event' divides by the total occurrences (impressions) of the specified Event
    Allowed
    sessionvisitorevent
  - time_windowstring
    Description
    The maximum amount of time a numerator event can differ from a denominator event in order to be included in a ratio metric. This can be an integer, or an integer followed by a letter denoting the unit of time (d = days, h = hours, m = minutes). If no unit of time is supplied, hours is assumed. If no value is supplied, a time window of 48 hours is assumed.
  - winning_directionstring<increasing | decreasing>
    Description
    The winning direction of this metric
    Allowed
    increasingdecreasing
- namestring
  Example
  Landing Page Optimization
  Description
  The name of the Campaign
- page_idsinteger[]
  Description
  A list of Page IDs used in the Campaign
- project_idinteger<int64>required
  Example
  1000
  Description
  The Project ID the Campaign is in
  Format
  int64
- statusstring<not_started | running | paused | archived>
  Description
  Current state of the Campaign. not_started means the Campaign has never been published to the world. running means the Campaign is currently live to the world. paused means the Campaign has been published, but is currently not running. archived means the Campaign is paused and not visible in the web UI.
  Allowed
  not_startedrunningpausedarchived
- typestring<personalization | other>
  Description
  Indicates the type of this campaign. Campaigns created or fetched via the API should currently all have a type of personalization, but if you get a campaign_id for an experiment and look it up, you may get an other value.
  Default
  personalization
  Allowed
  personalizationother
- url_targetingURLTargeting
  - activation_codestring
    Example
    function callbackFn(activate, options) { activate(); }
    Description
    Stringified Javascript function that determines when the Page is activated. Only required when activation_type is 'polling' or 'callback'.
  - activation_typestring<immediate | manual | polling | callback | dom_changed | url_changed>
    Example
    callback
    Description
    How this page is activated. See the full documentation on the Page object.
    Allowed
    immediatemanualpollingcallbackdom_changedurl_changed
  - conditionsstring
    Example
    [ "and", { "type": "url", "match_type": "substring", "value": "optimize" } ]
    Description
    Conditions to activate the experiment; our knowledge base article on Activation Types is the best guide for how to set up this data.
  - edit_urlstringrequired
    Example
    https://www.optimizely.com
    Description
    URL to load in the editor for this page
  - keystring
    Example
    home_page
    Description
    Unique string identifier for this Page within the Project
    Max Length
    64
    Pattern
    ^[a-zA-Z0-9_]+$
  - page_idinteger<int64>
    Example
    6700
    Description
    The unique identifier of the Page that represents the experiment or campaign's URL Targeting.
    Format
    int64

401Invalid credentials

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

403You do not have access to Campaigns 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/campaigns?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/campaigns?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/campaigns?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/campaigns?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 Campaigns
[
  {
    "archived": false,
    "changes": [
      {
        "async": false,
        "dependencies": [
          ""
        ],
        "id": "",
        "name": "Setting button text",
        "selector": "head",
        "src": "",
        "type": "",
        "value": "window.someGlobalFunction();"
      }
    ],
    "created": "",
    "custom_field_values": "",
    "description": "Tailor the landing page hero element for specific audiences",
    "earliest": "",
    "experiment_priorities": [
      [
        ""
      ]
    ],
    "for_journey": false,
    "holdback": 500,
    "id": 2000,
    "journey_id": "",
    "last_modified": "",
    "latest": "",
    "metrics": [
      {
        "aggregator": "",
        "display_title": "",
        "event_id": "",
        "event_properties": {
          "filter": {
            "combine_operator": "",
            "conditions": [
              {
                "name": "",
                "operator": "",
                "type": "",
                "value": ""
              }
            ]
          }
        },
        "field": "",
        "metrics": [
          {
            "aggregator": "",
            "event_id": "",
            "event_type": "",
            "field": "",
            "scope": ""
          }
        ],
        "scope": "",
        "time_window": "",
        "winning_direction": ""
      }
    ],
    "name": "Landing Page Optimization",
    "page_ids": [
      0
    ],
    "project_id": 1000,
    "status": "",
    "type": "",
    "url_targeting": {
      "activation_code": "function callbackFn(activate, options) { activate(); }",
      "activation_type": "callback",
      "conditions": "[\"and\", {\"type\": \"url\", \"match_type\": \"substring\", \"value\": \"optimize\"}]",
      "edit_url": "https://www.optimizely.com",
      "key": "home_page",
      "page_id": 6700
    }
  }
]

401

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

403

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

404

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

default

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