---
title: "List a site's invocation codes"
type: reference
method: GET
path: /rest-api/sites/{siteId}/invocation-codes.do
tag: "Sites"
---

# List a site's invocation codes

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

Lists the site's placements, grouped by zone, each with the invocation-code types the caller may generate for it. Deleted zones and placements are left out. The types are those the placement type offers minus those the caller lacks the per-type invocation-code permission for; fetch a code with GET /rest-api/placements/{placementId}/invocation-code. Requires VIEW access to the site's inventory (ALL, or SHARED with a share on the site).

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `siteId` | integer | yes | `5001` | Site ID |

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `limit` | integer | no | `50` | Placements per page, 1 to 1000 |
| `start` | integer | no | `0` | Offset of the first placement returned |

## Responses

- `200` — {success, total, data:[{zoneId, zoneName, placementId, placementName, placementType, codeTypes}]}
- `400` — start or limit out of range
- `401` — Authentication error
- `403` — No VIEW access to the site
- `404` — Site not found or deleted

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/sites/5001/invocation-codes.do?limit=50&start=0' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/sites/get-sites-invocation-codes