---
title: "List creative-scan verdicts"
type: reference
method: GET
path: /rest-api/dsp-creative-scan/search.do
tag: "DSP Creative Scan"
---

# List creative-scan verdicts

`GET https://YOUR-NETWORK-DOMAIN/rest-api/dsp-creative-scan/search.do`

What the scan has decided about the creatives the network's DSP partners bid with, newest first, with the console page's own filters. A creative is COUNTING until it has been seen often enough to be worth a scan, then PENDING_SCAN and SCANNING -- neither of which serves -- and ends at PASSED, which serves and is trusted until its whitelist expires, BLOCKED, which is dropped from the auction so the runner-up wins instead, or AUTO_APPROVED, which serves unscanned because the markup could not be submitted; skipReason says why, and PROVIDER_NOT_CONFIGURED among them means the partner names a provider this network has no account for. A creative that passed once keeps serving while it is re-checked, as PASSED_RESCANNING. Only partners with a scan provider ever appear here. The answer carries total and more, so a cut list is never read as the whole of it. Nothing here changes a verdict; mayChangeScanProvider says whether this caller also holds the DSP Partners permission, which is what the one remedy -- changing or clearing a partner's scan provider -- is under. Requires the DSP Creative Scan permission, which is a different permission from DSP Partners and does not imply it.

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `dspPartnerId` | integer | no | `12` | Only this DSP partner's creatives |
| `provider` | string | no | `GEO_EDGE` | Only creatives scanned by this provider: MEDIA_TRUST or GEO_EDGE |
| `status` | string | no | `BLOCKED` | Only creatives at this verdict: COUNTING, PENDING_SCAN, SCANNING, PASSED, BLOCKED, PASSED_RESCANNING or AUTO_APPROVED |
| `skipReason` | string | no | `VAST_VPAID` | Only AUTO_APPROVED creatives let through for this reason, e.g. VAST_VPAID, OVERSIZED_MARKUP, NATIVE_NO_LINK, SCAN_TIMEOUT, PROVIDER_NOT_CONFIGURED |
| `from` | string | no | `2026-11-01` | Only creatives first seen at or after this day or moment, ISO-8601 (2026-11-01 or 2026-11-01T00:00:00Z) |
| `to` | string | no | `2026-11-16` | Only creatives first seen at or before this day or moment, ISO-8601 |
| `start` | integer | no | `0` | Skip this many creatives (zero-based position in the sorted list). Default 0 |
| `limit` | integer | no | `50` | How many creatives to return, 1-500. Default 50 |
| `sort` | string | no | `createdAt` | Sort by: createdAt, scanSubmittedAt, scanCompletedAt, whitelistExpiresAt, impressionCount, status, skipReason, dspPartnerName, externalBannerId or id. Default createdAt |
| `dir` | string | no | `DESC` | DESC for newest or largest first (the default), ASC for the other way |

## Responses

- `200` — {success, mayChangeScanProvider, creatives:[{id, dspPartnerName, externalBannerId, status, ...}], returned, total, more}
- `400` — limit outside 1-500, start below 0, an unsortable column, or a date that is not ISO-8601
- `401` — Authentication error
- `403` — The caller does not hold the DSP Creative Scan permission

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/dsp-creative-scan/search.do?dspPartnerId=12&provider=GEO_EDGE&status=BLOCKED' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/dsp-creative-scan/get-dsp-creative-scan-search