---
title: "Get placement matched ads"
type: reference
method: GET
path: /rest-api/placements/{placementId}/matchedAds.do
tag: "Placements"
---

# Get placement matched ads

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

Returns all advertisers, campaigns, and banners that are rule-matched to the specified placement. Matching is determined by the ad serving rule engine which evaluates targeting rules at the advertiser, campaign, and banner levels. The response contains three arrays: matched advertisers (id, name), matched campaigns (id, name), and matched banners (id, name). Returns an error string if the placement is not found or deleted.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `placementId` | integer | yes | `4001` | Unique numeric ID of the placement |

## Responses

- `200` — Matched ads returned successfully
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — Forbidden — insufficient permissions
- `404` — No placement with this id, or it is deleted

## Example request

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

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