---
title: "Get site shares for user"
type: reference
method: GET
path: /rest-api/siteShares.do
tag: "Shares"
---

# Get site shares for user

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

Returns all site shares with access level info (Can Edit, Can View, Is Owner) for the specified user or the currently logged-in user if no userId is provided. When basicInfo is true, additional site details such as active status, creation date, contact name/email, description, and advertising category IDs are included in the response for all or selected entities. The response is a JSON array of share objects, each containing the site ID, name, share type, and optionally a basicInfo map. Deleted sites are left out. Requires SHARED or ALL level permission on INVENTORY with VIEW access; viewing shares of other users requires ALL permission.

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `userId` | integer | no | `5001` | Unique identifier of the user whose site shares should be retrieved. If omitted, returns shares for the currently authenticated user |
| `basicInfo` | boolean | no | `true` | When true, includes additional site details (active status, creation date, contact name/email, description, category IDs) in the response for each share entry |
| `basicInfoIds` | array<string> | no | `4001` | Comma-separated list of site IDs for which to include basic information. If omitted or empty while basicInfo is true, basic info is included for all sites |

## Responses

- `200` — Site shares retrieved successfully
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — Insufficient permissions

## Example request

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

Source: https://epom.com/ad-server/docs/api/shares/get-siteshares