---
title: "List all advertisers"
type: reference
method: GET
path: /rest-api/advertisers.do
tag: "Advertisers"
---

# List all advertisers

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

Returns all non-deleted advertisers for the authenticated user's account as a JSON array. Each advertiser object includes: id, name, active, category, and description (if set). Requires VIEW permission on CAMPAIGNS at ALL level (returns all advertisers) or SHARED level (returns only advertisers shared with the requester). Results can be optionally filtered by one or more advertising category IDs passed as query parameters, and by any on/off setting or relation flag (filter[...]); they are ordered by id, paged with offset and limit, and trimmed to the fields named in fields. If the user lacks both ALL and SHARED VIEW permissions, a 403 error is returned.

## 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. |
| `offset` | integer | no | `0` | Pagination offset over advertisers ordered by id (zero-based) |
| `limit` | integer | no | `100` | Maximum number of advertisers to return; omit for all |
| `fields` | array<string> | no | `id,name,active` | Return only these fields of each entity, comma-separated; id is always kept. A requested field no returned row carries is named in the X-Ignored-Fields response header |
| `filter` | object | no | `{"hasLimits": "true"}` | Keep only entities matching every key, e.g. filter[cpaOptimization]=true&filter[hasLimit]=true. Keys are the entity's on/off settings (active, enableTargeting, cpaOptimization, alwaysRedirect, ...) and a has<Relation> flag for each setting kept in rows of its own (hasLimit, hasPricing, hasFrequencyCapping, hasTrackingCode, hasPriceAdjustmentRules, hasLabels, hasBanners, ...), true when the relation holds a row; hasCapping, hasLimits and hasTargetingRules group the relations of their kind. An unknown key is a 400 that lists every valid key for the list. |

## Responses

- `200` — Array of advertiser objects
- `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.do?advertisingCategories=5&offset=0&limit=100' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

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