---
title: "Get banner targeting rules"
type: reference
method: GET
path: /rest-api/banner/{bannerId}/targetings.do
tag: "Targeting Rules"
---

# Get banner targeting rules

`GET https://YOUR-NETWORK-DOMAIN/rest-api/banner/{bannerId}/targetings.do`

Returns all targeting rules currently configured for the specified banner. Results can be filtered by targeting type (e.g., COUNTRY, BROWSER, DEVICE_FORMAT) and by rule (INCLUDE or EXCLUDE). Each targeting rule in the response includes its ID, type, rule, and value details. Requires UPDATE permission on the banner's campaign and MANAGE_DEMAND_TARGETING permission.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `bannerId` | integer | yes | `7890` | Unique numeric ID of the banner whose targeting rules to retrieve |

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `targetType` | string | no | `COUNTRY` | Optional targeting type filter — when specified, only rules of this type are returned (e.g., COUNTRY, BROWSER, DEVICE_FORMAT) |
| `rule` | string | no | `INCLUDE` | Optional rule filter — INCLUDE to return only whitelist rules, EXCLUDE to return only blacklist rules |

## Responses

- `200` — Success
- `400` — Bad request — invalid or missing parameters
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Banner not found
- `500` — Internal server error

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/banner/7890/targetings.do?targetType=COUNTRY&rule=INCLUDE' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/targeting-rules/get-banner-targetings