---
title: "List Traffic Quality scores of placements for a day"
type: reference
method: GET
path: /rest-api/traffic-quality/scores.do
tag: "Traffic Quality"
---

# List Traffic Quality scores of placements for a day

`GET https://YOUR-NETWORK-DOMAIN/rest-api/traffic-quality/scores.do`

One row per placement the caller may view that was scored that day (placements with at least 1,000 impressions), highest risk first: the score and level with the share of impressions from datacenters and proxies, declared crawlers, headless browsers, emulators, duplicates, risk-flagged IPs and geo mismatches, plus phantom (no impression) and fast clicks. Scores are computed once a day for the day before. Requires the Traffic Quality Reports permission.

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `date` | string | no | `2026-10-28` | Day, yyyy-MM-dd; default yesterday |
| `siteIds` | array<integer> | no | `161` | Keep only placements of these sites |
| `placementIds` | array<integer> | no | `3277` | Keep only these placements |
| `levels` | array<string> | no | `RED` | Keep only these levels: GREEN, YELLOW, RED, BLOCKED |
| `limit` | integer | no | `100` | Rows returned, highest risk first; default 100, at most 500 |

## Responses

- `200` — {success, date, summary {green, yellow, red, blocked, totalImpressions, fraudSpend}, total, more, limit, rows [...]}; total counts the matching placements, more says rows were cut at limit
- `400` — A date that is not yyyy-MM-dd or an unknown level
- `401` — Authentication error
- `403` — The role lacks the Traffic Quality Reports permission

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/traffic-quality/scores.do?date=2026-10-28&siteIds=161&placementIds=3277' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/traffic-quality/get-traffic-quality-scores