---
title: "List per-action limits"
type: reference
method: GET
path: /rest-api/per-action/limits/{type}/{entityId}.do
tag: "Limits"
---

# List per-action limits

`GET https://YOUR-NETWORK-DOMAIN/rest-api/per-action/limits/{type}/{entityId}.do`

Retrieves all per-action conversion limit objects configured for the specified entity type and entity ID. Per-action limits allow setting daily and total conversion caps on a per-action (goal) basis, in contrast to the global limits endpoints which cap all conversions together. The response JSON contains an 'actionLimits' array where each entry includes the limit ID, entity ID, action ID, totalConversionsLimit, totalConversions, dailyConversionsLimit, and dailyConversions. The entity type must be one of BANNER, CAMPAIGN, ADVERTISER, PLACEMENT, or SITE; unsupported types return 400.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `type` | string | yes | `CAMPAIGN` | Type of the parent entity whose per-action limits should be listed. Must be one of: BANNER, CAMPAIGN, ADVERTISER, PLACEMENT, SITE |
| `entityId` | integer | yes | `2001` | Unique numeric identifier of the parent entity (banner, campaign, advertiser, placement, or site) |

## Responses

- `200` — Per-action limits retrieved successfully
- `400` — Invalid parameters or unsupported entity type
- `401` — Authentication error
- `403` — The role lacks the permission the message names, or the entity is not yours to change
- `404` — Not found — resource does not exist

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/per-action/limits/CAMPAIGN/2001.do' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

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