---
title: "Get site video creative requirements"
type: reference
method: GET
path: /rest-api/sites/{siteId}/video-requirements.do
tag: "Sites"
---

# Get site video creative requirements

`GET https://YOUR-NETWORK-DOMAIN/rest-api/sites/{siteId}/video-requirements.do`

Returns the publisher's video creative requirements set on the site and whether they are switched on (enabled); an empty object means none; preset names the publisher spec they were filled from and whether they were changed since (modified). Every requirement is optional and only those present are checked: resolutions (each with an optional bitrate range in Mbps that wins over videoBitrate), videoBitrate {min, max} in Mbps, durations in seconds with durationTolerance (default 0.5), frameRates, containers (MP4, MOV, WEBM), videoCodecs (H264, HEVC, PRORES, VP9, AV1, MPEG2), audioCodecs (AAC, PCM, AC3, EAC3, MP3, OPUS), minAudioBitrate in kbps, audioChannels, maxFileSizeMb and loudness {target, tolerance} in LKFS. While the site's switch (enabled) is on, an uploaded video (LOCAL_VIDEO, or the best file of ADVANCED_LOCAL_VIDEOS) that fails them is linked as usual but not served on this site's placements; external video, VAST tags and DSP bids are not checked. Off keeps them but checks nothing. Requires VIEW access to the site and the SITE_VIDEO_CREATIVE_REQUIREMENTS permission (enabled or read-only).

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `siteId` | integer | yes | `5001` | Unique numeric ID of the site |

## Responses

- `200` — The site's requirements
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — Insufficient permissions, naming the missing one
- `404` — Site not found or deleted

## Example request

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

Source: https://epom.com/ad-server/docs/api/sites/get-sites-video-requirements