---
title: "List zone placements"
type: reference
method: GET
path: /rest-api/zones/{zoneId}/placements.do
tag: "Zones"
---

# List zone placements

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

Returns all non-deleted placements belonging to the specified zone, filtered to include only SITE_PLACEMENT, MOBILE_SITE_PLACEMENT, and NON_STANDARD_SITE_PLACEMENT types. Each placement in the response includes its ID, name, type, dimensions, active status, and associated ad unit information. Video, native, application, and click-through placement types are excluded from this listing.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `zoneId` | integer | yes | `3001` | Unique numeric ID of the zone whose placements to list |

## Responses

- `200` — Placements returned successfully
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — No VIEW share on the zone's site
- `404` — Zone with the given ID was not found or is deleted

## Example request

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

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