---
title: "List advertisers with campaigns and banners tree"
type: reference
method: GET
path: /rest-api/advertisers-tree.do
tag: "Advertisers"
---

# List advertisers with campaigns and banners tree

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

Returns all non-deleted advertisers with their nested campaigns and banners as a JSON array, forming a complete inventory tree. Each advertiser object includes standard advertiser fields (id, name, active, category, description) plus a 'campaigns' array, where each campaign contains its own fields and a nested 'banners' array. Deleted campaigns and banners are excluded from the tree. Requires VIEW permission on CAMPAIGNS at ALL level (returns all advertisers) or SHARED level (returns only shared advertisers). Results can be filtered by advertising category IDs. This endpoint is useful for building a full advertiser-campaign-banner hierarchy view in a single request; on a large network read it in pages with start and limit (advertisers ordered by id).

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `advertisingCategories` | array<integer> | no | `5` | Optional array of advertising category IDs to filter the results. Only advertisers belonging to at least one of the specified categories will be returned. Pass multiple values as repeated query parameters, e.g. advertisingCategories=1&advertisingCategories=5. |
| `start` | integer | no | `0` | Paging: skip this many advertisers (ordered by id). Default 0 |
| `limit` | integer | no | `20` | Paging: at most this many advertisers, each with all its campaigns and banners. Omitted — every advertiser. A page shorter than limit is the last one |

## Responses

- `200` — Array of advertiser objects with nested campaigns and banners
- `400` — Bad request — invalid or missing parameters
- `401` — Unauthorized — authentication failed or missing credentials
- `403` — Insufficient permissions

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/advertisers-tree.do?advertisingCategories=5&start=0&limit=20' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/advertisers/get-advertisers-tree