---
title: "Get banner placements — banners"
type: reference
method: GET
path: /rest-api/banners/{bannerId}/placements.do
tag: "Banners"
---

# Get banner placements — banners

`GET https://YOUR-NETWORK-DOMAIN/rest-api/banners/{bannerId}/placements.do`

Retrieves all placements currently linked to the specified banner, filtered to only include SITE_PLACEMENT, MOBILE_SITE_PLACEMENT, and NON_STANDARD_SITE_PLACEMENT types. The response is a JSON array of placement objects, each containing 'id' and 'name' fields. Deleted placements are excluded from the results; a placement on a site the caller may not view (or a foreign one under MASK_INVENTORY) is named PLACEMENT_{id} without its description. Requires VIEW permission on the banner's advertiser.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `bannerId` | integer | yes | `42` | Unique identifier of the banner whose linked placements should be retrieved |

## Responses

- `200` — List of linked placements
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — The caller may not view the banner's advertiser
- `404` — The banner does not exist or is deleted

## Example request

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

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