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

# Get site by ID

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

Returns the full details of a single publisher site by its numeric ID. The site must not be deleted and the requester must have VIEW permission on the site through ALL or SHARED level INVENTORY permissions. SSP sites are excluded from access when the user is SSP-filtered. Set basicInfo to true to include additional details like URL, email, and contact information. Every field sites/update writes is returned at the top level under the same name (active, url, bundle, inventoryType, impressionsByMonth, visitorsByMonth, schainSellerId, categoryId, ...; an unset one is left out); a field the console shows only with a permission the caller lacks is left out and listed, with that permission, in fieldsHiddenByPermission. approvalStatus is the network's approval of the site (APPROVED, PENDING or REJECTED); a site that is not APPROVED serves no ads. 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 |
|---|---|---|---|---|
| `siteId` | integer | yes | `5001` | Unique numeric ID of the site |

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `basicInfo` | boolean | no | `true` | If true, includes additional site details such as URL, email, and contact info |

## Responses

- `200` — Site returned successfully
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — Access forbidden for this site
- `404` — Site not found or deleted

## Example request

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

Source: https://epom.com/ad-server/docs/api/sites/get-sites-by-site-id