---
title: "Get prototype actions by banner IDs"
type: reference
method: GET
path: /rest-api/prototype/banner/action.do
tag: "Banners"
---

# Get prototype actions by banner IDs

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

Retrieves the default action configurations for banner prototypes that match the specified set of banner IDs. This is useful for bulk-loading action tracking URLs (click tracking, pixel tracking, sub-ID tracking) for multiple banners at once. The response contains a JSON array of unique action objects extracted from the matching prototypes. The returned actionTrackUrl and subIdActionTrackUrl carry an att= placeholder — replace it with click or view to declare how the conversion was attributed, or fire the URL as is, which is read as no declaration. Requires REST API authentication.

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `bannerIds` | array<integer> | yes | `5001` | Comma-separated set of unique numeric banner IDs to look up prototype actions for (e.g. bannerIds=838,839,840) |

## Responses

- `200` — JSON array of action objects, each containing id, actionTrackUrl, pixelTracking, securePixelTracking, subIdActionTrackUrl, and code
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error - invalid hash, timestamp, or username
- `403` — Forbidden — insufficient permissions
- `500` — Internal server error while retrieving prototype actions

## Example request

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

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