---
title: "Read how much scan budget is left"
type: reference
method: GET
path: /rest-api/dsp-creative-scan/pacer-status.do
tag: "DSP Creative Scan"
---

# Read how much scan budget is left

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

Per provider: how many scans this network has spent of its monthly budget, how much of it that is, and the two numbers the budget is paced with -- the impressions a creative has to be seen before it is worth a scan, and how long a passed creative is trusted before it is checked again. Both tighten as the budget runs down, and once hasBudget is false the threshold reads MAX and nothing further is submitted this month: creatives already passed keep serving, new ones stay counting. Also how many verdicts the ad servers are holding in memory and how many creatives are being counted, which is what the serving path reads rather than the database. Requires the DSP Creative Scan permission.

## Responses

- `200` — {success, mayChangeScanProvider, providers:[{provider, scansUsed, maxMonthly, usagePercent, effectiveThreshold, effectiveWhitelistTtlHours, hasBudget}], whitelistCacheSize, impressionCounterSize}
- `400` — Bad request — invalid or missing parameters
- `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/pacer-status.do' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

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