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

# Generate the Traffic Quality report of a placement

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

Starts the full report of the placement and day in the background: the deep analysis on the analytics cluster (unless already stored), then the ad server's own AI findings and the PDF. It takes noticeably longer than POST detail and uses the network's Anthropic key; prefer POST detail when the caller analyses the data itself, and this when the PDF or the ad server's write-up is wanted. Poll GET report until status is ready. Asked for while the analysis alone runs for this placement and day, the report is written by that run once the analysis is stored. One analysis or report runs at a time across the network, and an existing report is kept. 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 |

## Form 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 (it already exists) | started | generating (already running for this placement and day), runningMinutes (while generating)}
- `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
- `429` — Another placement's analysis or report is running; the message names it and how long it has run

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/traffic-quality/3277/report.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'date=2026-10-28'
```

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