---
title: "Get banner prototype by campaign type"
type: reference
method: GET
path: /rest-api/prototype/banner/{prototypeType}.do
tag: "Banners"
---

# Get banner prototype by campaign type

`GET https://YOUR-NETWORK-DOMAIN/rest-api/prototype/banner/{prototypeType}.do`

Retrieves the self-serve campaign banner prototype associated with the specified campaign type. The prototypeType path variable is a SelfServeCampaignType enum value (e.g. BANNER_DESKTOP, BANNER_MOBILE, VIDEO_DESKTOP). The response includes the full prototype details including banner metadata and the default action configuration. Returns HTTP 400 if no prototype is configured for the given campaign type. Requires REST API authentication.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `prototypeType` | string | yes | `BANNER_DESKTOP` | Self-serve campaign type enum value (e.g. BANNER_DESKTOP, BANNER_MOBILE, VIDEO_DESKTOP, VIDEO_MOBILE) |

## Responses

- `200` — JSON object containing the banner prototype with id, type, banner details, and defaultAction
- `400` — Bad request - no prototype configured for the specified campaign type
- `401` — Authentication error - invalid hash, timestamp, or username
- `403` — Forbidden — insufficient permissions
- `404` — Not found — resource does not exist
- `500` — Internal server error while retrieving the prototype

## Example request

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

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