---
title: "Get campaign limits in bulk"
type: reference
method: GET
path: /rest-api/campaign/limits.do
tag: "Limits"
---

# Get campaign limits in bulk

`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

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `campaignIds` | array<integer> | no | `2001` | Comma-separated list of campaign IDs to retrieve limits for. If omitted, returns limits for all accessible campaigns |
| `startDateFrom` | string | no | `2025-01-15-00-00` | 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 |
| `startDateTo` | string | no | `2025-12-31-23-59` | 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 |
| `activeCampaignOnly` | boolean | no | `false` | When set to true, only campaigns with active status are included in the results. Defaults to 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

## Example request

```bash
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'
```

Source: https://epom.com/ad-server/docs/api/limits/get-campaign-limits