Get placement daisy chaining

Reference

GET https://YOUR-NETWORK-DOMAIN/rest-api/placements/{placementId}/chaining.do

Returns the daisy chaining (ad waterfall) configuration for the specified placement, including the ordered priority list of campaigns or banners, lookup depth, and the chain options the setup endpoint sets (viewPerEntityEnabled/viewPerEntityCount, rotatingEnabled/rotatingCount, groupByDeliveryPriority). The chaining type can be either Banner-level or Campaign-level, and may optionally group entries by delivery priority (Premium, Standard High, etc.) and country. While grouped, deliveryPriorityFilters lists the delivery priorities kept in the chain with their countries ('*' for every country), as set through /rest-api/placements/{placementId}/chaining/delivery-priority-filter.do. placementId and enabled are returned as the setup endpoint answers them; with daisy chaining off the answer is {placementId, enabled:false, daisyChains:[]}. Requires ENABLED or READONLY level on the DAISY_CHAINING permission and VIEW permission on the parent site's inventory.

Path Params

placementId integer required

Unique numeric ID of the placement

4001

Responses

200

Daisy chaining info returned successfully (daisyChains is empty when the placement has no chaining)

400

Bad request — invalid or missing parameters

401

Authentication error

403

Permission denied

404

No placement with this id, or it is deleted

Language

cURL Request

curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/placements/4001/chaining.do' \
  --header 'X-Api-Key: YOUR_API_KEY'

Python Request

import requests

response = requests.request("GET", "https://YOUR-NETWORK-DOMAIN/rest-api/placements/4001/chaining.do", headers={"X-Api-Key": "YOUR_API_KEY"})
print(response.json())

Node Request

const response = await fetch('https://YOUR-NETWORK-DOMAIN/rest-api/placements/4001/chaining.do', {
  method: 'GET',
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
});

console.log(await response.json());

Java Request

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://YOUR-NETWORK-DOMAIN/rest-api/placements/4001/chaining.do"))
    .header("X-Api-Key", "YOUR_API_KEY")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

C# Request

using var client = new HttpClient();

var request = new HttpRequestMessage(new HttpMethod("GET"), "https://YOUR-NETWORK-DOMAIN/rest-api/placements/4001/chaining.do");
request.Headers.Add("X-Api-Key", "YOUR_API_KEY");

var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Go Request

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://YOUR-NETWORK-DOMAIN/rest-api/placements/4001/chaining.do", nil)
	req.Header.Set("X-Api-Key", "YOUR_API_KEY")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	out, _ := io.ReadAll(res.Body)
	fmt.Println(string(out))
}

PHP Request

<?php
$ch = curl_init("https://YOUR-NETWORK-DOMAIN/rest-api/placements/4001/chaining.do");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY"]);

echo curl_exec($ch);
curl_close($ch);

Ruby Request

require 'net/http'
require 'json'

uri = URI("https://YOUR-NETWORK-DOMAIN/rest-api/placements/4001/chaining.do")
request = Net::HTTP::Get.new(uri)
request['X-Api-Key'] = 'YOUR_API_KEY'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
puts response.body