---
title: "Get placement limits"
type: reference
method: GET
path: /rest-api/placement/{placementId}/limits.do
tag: "Limits"
---

# Get placement limits

`GET https://YOUR-NETWORK-DOMAIN/rest-api/placement/{placementId}/limits.do`

Reads the delivery limits of a placement: every request, impression, click and conversion cap and counter (daily, weekly, monthly, total) the caller may see, startDate/endDate (yyyy-MM-dd-HH-mm, GMT+0), evenPacing, useLocalTime and limitsSet=true. A placement without limits answers {placementId, limitsSet:false}. A cap whose INVENTORY_*_LIMIT permission the role lacks is left out and listed, with that permission, in fieldsHiddenByPermission. Requires a share on the placement's site and the MANAGE_INVENTORY_LIMIT permission (READONLY is enough).

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `placementId` | integer | yes | `3001` | ID of the placement |

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `timezoneOffset` | integer | no | `120` | The caller's offset from UTC in minutes (east positive). With the limit on local time, startDate/endDate are answered in that offset, as the console shows them; omitted, they are in UTC |

## Responses

- `200` — Placement limits, or {placementId, limitsSet:false} when none are set
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — No share on the site or no MANAGE_INVENTORY_LIMIT permission
- `404` — Placement not found

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/placement/3001/limits.do?timezoneOffset=120' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

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