---
title: "Get placement invocation code"
type: reference
method: GET
path: /rest-api/placement/{key}/code.do
tag: "Placements"
---

# Get placement invocation code

`GET https://YOUR-NETWORK-DOMAIN/rest-api/placement/{key}/code.do`

Returns a specific invocation code format for a placement identified by its unique key. The code type parameter determines the output format: IFRAME_SIMPLE, VIDEO_PLAYER, API, DIRECT_URL, EMAIL, AJAX or JS_MOUNT. This is the preferred endpoint for retrieving placement invocation codes.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `key` | string | yes | `a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4` | Unique placement key string (MD5 hash) |

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `t` | string | yes | `AJAX` | Invocation code type: IFRAME_SIMPLE, VIDEO_PLAYER, API, DIRECT_URL, EMAIL, AJAX or JS_MOUNT |
| `tpId` | integer | no | `101` | Test page ID for generating test page specific code (internal use) |

## Responses

- `200` — Invocation code returned
- `400` — Bad request — invalid or missing parameters
- `404` — No live placement has this key

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/placement/a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4/code.do?t=AJAX&tpId=101' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/placements/get-placement-code-by-key-id