---
title: "Get placement"
type: reference
method: GET
path: /rest-api/placements/{placementId}.do
tag: "Placements"
---

# Get placement

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

Returns one placement: everything placements/summary returns for it (id, name, description, type, key, active, size and dimensions, zoneId, zoneName, siteId, siteName, category, labels, defaultCode, targeting switch, native preferences and adapter template, video player settings) plus every scalar setting the update endpoints accept, under the same names. A video placement also reads back its videoFormats, skipButtonEnabled, skipButtonShowAfterSeconds, vmapMaxNumberOfPreRolls, vastDefaultAdTitle, ssaiStitcher and podSeparation, plus, with the Video RTB Configuration permission (enabled or read-only), videoPlaybackMethod and videoApiFramework; an unset one, such as ssaiStitcher with no stitcher or podSeparation when it is off, is left out. A placement on inventory the caller sees masked comes back masked, as in the summary. Its Open RTB card (IAB categories, blocked IAB categories, blocked banner attributes) is read by placements/{placementId}/openrtb. Requires VIEW access to the placement's site (ALL, or SHARED with a share on the site). The response also carries additionalFieldValues: every custom field the network defines for this entity type, keyed by field id, each with its name and this entity's value (null when unset) - the values of /rest-api/additional-fields/{entityType}/{entityId}.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `placementId` | integer | yes | `4001` | Placement ID |

## Responses

- `200` — The placement
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — No VIEW access to the placement's site
- `404` — Placement not found, deleted, or of a type the placement API does not manage

## Example request

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

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