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

# Get advertiser shares for user

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

Returns all advertiser 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 advertiser details such as active status, creation date, contact info, 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 advertiser ID, name, share type, and optionally a basicInfo map. Deleted advertisers are left out. Requires SHARED or ALL level permission on CAMPAIGNS with VIEW access; viewing shares of other users requires ALL permission.

## Query params

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

## Responses

- `200` — Advertiser 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/advertiserShares.do?basicInfo=true&basicInfoIds=1001&userId=5001' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

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