---
title: "Get the Traffic Quality report of a placement"
type: reference
method: GET
path: /rest-api/traffic-quality/{placementId}/report.do
tag: "Traffic Quality"
---

# Get the Traffic Quality report of a placement

`GET https://YOUR-NETWORK-DOMAIN/rest-api/traffic-quality/{placementId}/report.do`

Whether the placement's report for the day is ready, being generated, failed (with the reason) or not started, with its AI findings (verdict, summary, the signals behind them and recommendations) and a download link to the PDF once it is ready. Findings are absent for a report made before they were stored or without an Anthropic key. Requires the Traffic Quality Reports permission and view permission on the placement's site.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `placementId` | integer | yes | `3277` | Placement id |

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `date` | string | no | `2026-10-28` | Day, yyyy-MM-dd; default yesterday |

## Responses

- `200` — {success, placementId, date, status: ready | generating | failed | none, runningMinutes (while generating), failure (when failed), analysis {...} | null, pdfUrl | null}
- `400` — A date that is not yyyy-MM-dd
- `401` — Authentication error
- `403` — The role lacks the Traffic Quality Reports permission or view permission on the site
- `404` — No such placement, or no score for it that day

## Example request

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

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