---
title: "List recently deleted entities"
type: reference
method: GET
path: /rest-api/deleted-entities/list.do
tag: "Recently Deleted"
---

# List recently deleted entities

`GET https://YOUR-NETWORK-DOMAIN/rest-api/deleted-entities/list.do`

Advertisers, campaigns, banners, sites, zones and placements deleted in the last 90 days and not restored yet, newest first - only those under an advertiser or site the caller may view. Each item is the entity a user deleted: what its delete took down with it (the campaigns and banners of a deleted advertiser, the zones and placements of a deleted site) is counted in cascaded and comes back with it. Each item carries deletionId, type, id, name, deletedAt (ISO-8601 instant), deletedBy {id, username}, its ancestors (advertiserId/advertiserName, campaignId/campaignName, siteId/siteName, zoneId/zoneName), cascaded {TYPE: count}, links (banner-placement links the delete removed), linksLost (those of them whose placement or banner is deleted now, so a restore cannot make them again), canRestore (the caller may delete it, which restoring takes) and blockedBy {type, id, name}: a deleted ancestor that has to be restored first. Deletions made before deletions were recorded are not listed and cannot be restored here.

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `types` | array<string> | no | `BANNER` | Only these entity types: ADVERTISER, CAMPAIGN, BANNER, SITE, ZONE, PLACEMENT. Default: all |
| `ancestorType` | string | no | `ADVERTISER` | With ancestorId: only entities under this ADVERTISER, CAMPAIGN, SITE or ZONE |
| `ancestorId` | integer | no | `1001` | With ancestorType: the id of that advertiser, campaign, site or zone |
| `start` | integer | no | `0` | Skip this many items. Default 0 |
| `limit` | integer | no | `50` | How many items to return, 1-200. Default 50 |

## Responses

- `200` — {success, items:[...], total, start, returned, truncated, retentionDays}
- `400` — Unknown type, ancestorType without ancestorId, limit outside 1-200 or start below 0
- `401` — Authentication error
- `403` — Forbidden — insufficient permissions

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/deleted-entities/list.do?types=BANNER&ancestorType=ADVERTISER&ancestorId=1001' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/recently-deleted/get-deleted-entities-list