---
title: "Read a placement's Open RTB settings"
type: reference
method: GET
path: /rest-api/placements/{placementId}/openrtb.do
tag: "Categories"
---

# Read a placement's Open RTB settings

`GET https://YOUR-NETWORK-DOMAIN/rest-api/placements/{placementId}/openrtb.do`

Returns the placement's Open RTB settings from the console's Open RTB card: its custom OpenRTB tag id (sent as imp.tagid instead of the placement key when set), the IAB categories sent for it in bid requests, the IAB categories whose ads it refuses and the banner (creative) attributes it blocks. Needs the Open RTB permission and view rights on the placement's site.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `placementId` | integer | yes | `4001` | Placement id |

## Responses

- `200` — {placementId, customOpenRtbTagId, iabCategories:[{id, code, description}], blockedIabCategories:[…], blockedBannerAttributes:[{name, id, description}]}
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — The Open RTB permission is off, or no view rights on the placement's site
- `404` — The placement does not exist or is deleted

## Example request

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

Source: https://epom.com/ad-server/docs/api/categories/get-placements-openrtb