Browse the help center

List creative-scan verdicts

What the scan has decided about the creatives the network's DSP partners bid with, newest first, with the console page's own filters.

Reference
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

dspPartnerId integer

Only this DSP partner's creatives

12

provider string

Only creatives scanned by this provider: MEDIA_TRUST or GEO_EDGE

GEO_EDGE

status string

Only creatives at this verdict: COUNTING, PENDING_SCAN, SCANNING, PASSED, BLOCKED, PASSED_RESCANNING or AUTO_APPROVED

BLOCKED

skipReason string

Only AUTO_APPROVED creatives let through for this reason, e.g. VAST_VPAID, OVERSIZED_MARKUP, NATIVE_NO_LINK, SCAN_TIMEOUT, PROVIDER_NOT_CONFIGURED

VAST_VPAID

from string

Only creatives first seen at or after this day or moment, ISO-8601 (2026-11-01 or 2026-11-01T00:00:00Z)

2026-11-01

to string

Only creatives first seen at or before this day or moment, ISO-8601

2026-11-16

start integer

Skip this many creatives (zero-based position in the sorted list). Default 0

0

limit integer

How many creatives to return, 1-500. Default 50

50

sort string

Sort by: createdAt, scanSubmittedAt, scanCompletedAt, whitelistExpiresAt, impressionCount, status, skipReason, dspPartnerName, externalBannerId or id. Default createdAt

createdAt

dir string

DESC for newest or largest first (the default), ASC for the other way

DESC

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

Please disable Adblock
Are you using adblock? Disable it and reload the page to proceed to the destination page.

A registration has already been submitted from this page. Please try again in 10 minutes.