---
title: "Get ad unit values by placement type"
type: reference
method: GET
path: /rest-api/banner/adunit/values.do
tag: "Banners"
---

# Get ad unit values by placement type

`GET https://YOUR-NETWORK-DOMAIN/rest-api/banner/adunit/values.do`

Returns all available banner ad unit (size) values for the given placement type. Ad units define the creative dimensions (e.g., 300x250, 728x90). Use this endpoint to populate ad unit selection dropdowns when creating or editing banners.

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `placementType` | string | yes | `SITE_PLACEMENT` | Placement type: SITE_PLACEMENT, MOBILE_SITE_PLACEMENT, VIDEO_PLACEMENT, or APPLICATION_PLACEMENT |

## Responses

- `200` — List of ad unit values
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — Not enough permissions
- `404` — No matching ad units found

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/banner/adunit/values.do?placementType=SITE_PLACEMENT' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/banners/get-banner-adunit-values