---
title: "List campaigns for advertiser"
type: reference
method: GET
path: /rest-api/advertiser/{advertiserId}/campaigns.do
tag: "Advertisers"
---

# List campaigns for advertiser

`GET https://YOUR-NETWORK-DOMAIN/rest-api/advertiser/{advertiserId}/campaigns.do`

Returns all campaigns belonging to the specified advertiser as a JSON array. Each campaign object includes detailed fields: id, name, active, advertiserId, priority, weight, exchangeRate, ctrOptimization, cpaOptimization, ecpmOptimization, enableActions, enableTargeting, creation_time, description, bannerIds, bannersCount, labels, autoLinkCategories, status, hasTraffic, and direct-deal fields when applicable. The authenticated user must have VIEW permission on CAMPAIGNS (via share or ALL level) for the advertiser. Each campaign's 'status' array holds UI status tokens computed from traffic statistics, which are not the on/off switch — that is the 'active' field: status-active = switched on AND served traffic in the last ~6 hours; status-not-active = switched off OR no traffic in the last ~6 hours, so active=true together with status-not-active is normal for an idle, not-yet-started or newly created campaign; status-finished (added alongside) = the campaign's delivery limits have ended it — end date passed, total limit reached or an action limit reached. 'hasTraffic' is the same ~6-hour traffic flag on its own. Traffic data is refreshed hourly. A deleted campaign has an empty array.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `advertiserId` | integer | yes | `1001` | Unique numeric ID of the advertiser whose campaigns to list |

## Responses

- `200` — Array of campaign objects
- `400` — Bad request — invalid or missing parameters
- `401` — Unauthorized — authentication failed or missing credentials
- `403` — Insufficient permissions
- `404` — Advertiser not found or deleted

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/advertiser/1001/campaigns.do' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

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