---
title: "Get banner by ID"
type: reference
method: GET
path: /rest-api/banner/{bannerId}.do
tag: "Banners"
---

# Get banner by ID

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

Retrieves full details of a single banner by its ID, including labels, linkage status, traffic state, and native preferences (for native placement banners). The user must have VIEW permission on the banner's advertiser. Returns 404 if the banner does not exist or has been deleted. The response also carries additionalFieldValues: every custom field the network defines for this entity type, keyed by field id, each with its name and this entity's value (null when unset) - the values of /rest-api/additional-fields/{entityType}/{entityId}.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `bannerId` | integer | yes | `3001` | ID of the banner to retrieve |

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `selfServRequest` | boolean | no | `false` | If true, returns the Self-Serve response format |

## Responses

- `200` — Banner details
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — Not enough permissions
- `404` — Banner not found

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/banner/3001.do?selfServRequest=false' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

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