---
title: "List banner prototypes"
type: reference
method: GET
path: /rest-api/prototype/list.do
tag: "Banners"
---

# List banner prototypes

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

Returns all available self-serve campaign banner prototypes. Each prototype includes the prototype ID, self-serve campaign type (e.g. BANNER_DESKTOP, BANNER_MOBILE), the full banner details (name, dimensions, bannerType, ad unit, approval status, etc.), and the default action configuration with tracking URLs. This endpoint is typically used to populate prototype selection UI when creating new self-serve campaigns. Requires REST API authentication.

## Responses

- `200` — JSON array of banner prototype objects, each containing id, type, banner details, and defaultAction
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error - invalid hash, timestamp, or username
- `403` — Forbidden — insufficient permissions

## Example request

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

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