---
title: "List sites by IDs"
type: reference
method: GET
path: /rest-api/sites/ids.do
tag: "Sites"
---

# List sites by IDs

`GET https://YOUR-NETWORK-DOMAIN/rest-api/sites/ids.do`

Returns non-deleted publisher sites matching the given list of site IDs. Requires ALL or SHARED level VIEW permission on INVENTORY. When using SHARED level, only sites with an active share to the requester are returned. Set basicInfo to true to include additional details like URL, email, and contact information.

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `siteIds` | array<integer> | yes | `5001` | Array of site IDs to retrieve |
| `basicInfo` | boolean | no | `true` | If true, includes additional site details such as URL, email, and contact info |

## Responses

- `200` — Sites returned successfully
- `400` — siteIds missing or empty
- `401` — Authentication error
- `403` — No VIEW permission on INVENTORY

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/sites/ids.do?siteIds=5001&basicInfo=true' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

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