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.
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