Get campaign limits in bulk

Retrieves limits for multiple campaigns in a single request, with optional filtering by campaign IDs, limit start date range, and active campaign status.

Reference

GET https://YOUR-NETWORK-DOMAIN/rest-api/campaign/limits.do

Retrieves limits for multiple campaigns in a single request, with optional filtering by campaign IDs, limit start date range, and active campaign status. The response JSON contains a 'limits' array of limit objects (each with total/daily thresholds and counters), a 'withNoLimits' field listing campaign IDs that have no limits enabled, and optionally 'notFound' and 'accessForbidden' fields listing campaign IDs that were not found or not accessible. Requires UPDATE permission on each campaign's advertiser and the MANAGE_CAPPING_AND_LIMITATIONS user permission. Each cap and counter (budget, opportunities, impressions, clicks, conversions — every period) is shown only when the role holds its limit permission (e.g. WEEKLY_CLICKS_LIMIT, MONTHLY_BUDGET) enabled or readonly, like the console Limits card.

Query Params

campaignIds array<integer>

Comma-separated list of campaign IDs to retrieve limits for. If omitted, returns limits for all accessible campaigns

2001

startDateFrom string

Lower bound filter for the limit start date (inclusive), in yyyy-MM-dd-HH-mm (or yyyy-MM-dd HH:mm) format (GMT+0). Only campaigns whose limit start date is on or after this value are included

2025-01-15-00-00

startDateTo string

Upper bound filter for the limit start date (inclusive), in yyyy-MM-dd-HH-mm (or yyyy-MM-dd HH:mm) format (GMT+0). Only campaigns whose limit start date is on or before this value are included

2025-12-31-23-59

activeCampaignOnly boolean

When set to true, only campaigns with active status are included in the results. Defaults to false

false

Responses

200

Campaign limits retrieved successfully

400

Bad request — invalid or missing parameters

401

Authentication error

403

Not enough permissions

404

No limits set for such campaign

Language

cURL Request

curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/campaign/limits.do?campaignIds=2001&startDateFrom=2025-01-15-00-00&startDateTo=2025-12-31-23-59' \
  --header 'X-Api-Key: YOUR_API_KEY'

Python Request

import requests

response = requests.request("GET", "https://YOUR-NETWORK-DOMAIN/rest-api/campaign/limits.do?campaignIds=2001&startDateFrom=2025-01-15-00-00&startDateTo=2025-12-31-23-59", headers={"X-Api-Key": "YOUR_API_KEY"})
print(response.json())

Node Request

const response = await fetch('https://YOUR-NETWORK-DOMAIN/rest-api/campaign/limits.do?campaignIds=2001&startDateFrom=2025-01-15-00-00&startDateTo=2025-12-31-23-59', {
  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/campaign/limits.do?campaignIds=2001&startDateFrom=2025-01-15-00-00&startDateTo=2025-12-31-23-59"))
    .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/campaign/limits.do?campaignIds=2001&startDateFrom=2025-01-15-00-00&startDateTo=2025-12-31-23-59");
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/campaign/limits.do?campaignIds=2001&startDateFrom=2025-01-15-00-00&startDateTo=2025-12-31-23-59", 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/campaign/limits.do?campaignIds=2001&startDateFrom=2025-01-15-00-00&startDateTo=2025-12-31-23-59");
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/campaign/limits.do?campaignIds=2001&startDateFrom=2025-01-15-00-00&startDateTo=2025-12-31-23-59")
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