---
title: "Get ad unit list"
type: reference
method: GET
path: /rest-api/adunit/list.do
tag: "Users"
---

# Get ad unit list

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

Returns the full catalog of ad units (creative sizes). Each ad unit in the response contains id, width, height, name, and whether it is a custom size. Requires authentication (hash+timestamp+username query params or an active session).

## Responses

- `200` — JSON array of ad unit objects, e.g. [{id, height, width, name, custom}, ...]
- `400` — Bad request — invalid or missing parameters
- `401` — Unauthorized — authentication error (invalid hash, expired timestamp, or missing credentials)
- `403` — Forbidden — insufficient permissions

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/adunit/list.do' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/users/get-adunit-list