---
title: "Get multiple banner limits"
type: reference
method: GET
path: /rest-api/banners/limits.do
tag: "Limits"
---

# Get multiple banner limits

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

Retrieves limits for multiple banners in a single request. Banners that exist but have no limits enabled are silently skipped in the response. The response is a JSON array of limit objects, each containing total/daily thresholds and current counter values. Permission is checked individually for each banner's parent advertiser; if any banner is not found, a 404 is returned immediately. Requires UPDATE permission on each banner'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 |
|---|---|---|---|---|
| `bannerIds` | array<integer> | yes | `42` | Comma-separated list of banner IDs whose limits should be retrieved |

## Responses

- `200` — Banner limits retrieved successfully
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — Not enough permissions
- `404` — One of the provided banners not found

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/banners/limits.do?bannerIds=42' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

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